@armanatz/expo-hms-location

中文文档
1.0.3发布于 2025/01/07MITTypeScriptCommonJS零依赖近 30 天下载 2382

在预建中配置 @hmscore/ react-native-hms- 位置的 Expos 配置插件

中文使用文档
文档目录6 节
  1. 兼容性
  2. 先决条件
  3. 安装
  4. 配置
  5. 员额配置
  6. 由此插件更改

@armanatz/expo-hms- 地点

此 Expo 配置插件 自动配置@ hmscore/ react- native- hms- location 这样可以使用 在使用连续原住民世代的博览会应用程序中.

兼容性

此插件目前仅用于Android,没有计划添加 iOS 支持 现在 我对公关很开放,但是如果你需要iOS的支持,那么你可以随意创建公司.

这个插件是针对 Expo SDK 51. 编写和测试的. 它应与以后的版本相配合 除非他们内部有所改变 如果超过51的版本无效的话, 留下一个问题 我会调查的.

毋庸置疑, 但是这个插件不能按要求用于“ Expo Go” 应用程序 定制本地代码.

先决条件

确保您拥有一个 Huawei AppGallery 连接账户并创建了 Android 在使用此插件之前, 工程会在那里 .

这是需要的 因为你需要 agconnect-services.json 关联文件 你的项目.

安装

首先安装底部 React 原生 HMS 位置包 :

npm install --save @hmscore/react-native-hms-location

然后安装此插件 :

npx expo install @armanatz/expo-hms-location

配置

添加 @armanatz/expo-hms-location 到您的应用的 Expo 配置文件( app. json, 或 app. config. js) .

该插件会曝光以下选项:

选项类型说明
agConnectServicesFile字符串您的路径 agconnect-services.json 文档.
isBackgroundLocationEnabled布尔(可选) 启用背景中的定位服务
enableBouncyCastleFix布尔(备选) 如果您得到与 org.bouncycastle (如使用时) expo-updates),然后将此设定为真实

来了! 关键!: 选项 agConnectServicesFile 必须提供,否则预建会失败.


示例配置 :

"expo": {
  ...
  "plugins": [
      [
        "@armanatz/expo-hms-location",
        {
          "agConnectServicesFile": "./path/to/agconnect-services.json",
          "isBackgroundLocationEnabled": true,
          "enableBouncyCastleFix": true
        }
      ]
  ]
}

员额配置

在您的 Expo 配置文件中添加插件后, 请确保您重建您的应用程序 通过运行 prebuild 这样插件就可以相应应用其修改.

如果一切顺利,你的应用应该可以使用 @hmscore/react-native-hms-location 软件包.

由此插件更改

  1. 拷贝你 agconnect-services.json 转到 android/app 目录
  2. 从中提取应用程序的 App ID agconnect-services.json
  3. 已提取的 App ID 设置 AndroidManifest.xml
  4. 添加相关位置权限 AndroidManifest.xml 总计 华伟的医生
  5. 添加 Huawei 开发者 Maven repo 到工程的 build.gradle 文件
  6. 将Android Gradle 构建工具版本针入到 8.6.0 (这是因为华威SDK 造成建设错误而没有它)
  7. 将Huawei AGCP SDK 添加到项目中 build.gradle 文件
  8. 在应用程序内部应用 Huawei AGConnect 插件 build.gradle 文件
  9. 在应用程序中添加 Huawei 位置 Kit SDK build.gradle 文件
  10. 若为 enableBouncyCastleFix 被设定为真实,将解决 org.bouncycastle 依赖性

版本与发布记录

@armanatz/expo-hms-location 共发布 4 个版本,首次发布于 2024/09/18;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.3latest2025/01/071.8 年前
1.0.22024/10/242 年前
1.0.12024/09/182 年前
1.0.02024/09/182 年前

关于 @armanatz/expo-hms-location 的常见问题

@armanatz/expo-hms-location 是什么?

在预建中配置 @hmscore/ react-native-hms- 位置的 Expos 配置插件

如何安装 @armanatz/expo-hms-location?

在项目目录运行 npm install @armanatz/expo-hms-location,或使用 pnpm add / yarn add / bun add。

@armanatz/expo-hms-location 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@armanatz/expo-hms-location 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@armanatz/expo-hms-location 可以商用吗?

@armanatz/expo-hms-location 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@armanatz/expo-hms-location 的下载量有多少?

根据 npm 官方下载统计,@armanatz/expo-hms-location 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,382 次,日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@armanatz/expo-hms-location 还在维护吗?

最新版本 1.0.3 发布于 2025/01/07(1.8 年前);至今共发布 4 个版本,其中过去 12 个月发布了 0 个;首次发布于 2024/09/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。