# @armanatz/expo-hms-location 中文文档

规范地址：https://npmcn.com/package/%40armanatz/expo-hms-location/

版本：1\.0\.3
npm 元数据更新时间：2025-01-07T08:27:13.543Z
中文译文更新时间：2026-11-06T20:18:01.327Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40armanatz/expo-hms-location
原文对照：https://npmcn.com/package/%40armanatz/expo-hms-location/?lang=original
项目主页：https://github.com/armanatz/expo-hms-location#README.md
源码仓库：https://github.com/armanatz/expo-hms-location

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：33.5 kB，26 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：expo \>=51
- 首次发布：2024-09-18T13:52:03.969Z
- 最新版本发布：2025-01-07T08:27:13.370Z
- 近 30 天下载量：2382（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

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

## 安装

```sh
npm install @armanatz/expo-hms-location
```

也可以使用：`pnpm add @armanatz/expo-hms-location`、`yarn add @armanatz/expo-hms-location`、`bun add @armanatz/expo-hms-location`

## README

# @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 位置包 :

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

然后安装此插件 :

```sh
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` 总计 [华伟的医生](https://developer.huawei.com/consumer/en/doc/HMS-Plugin-Guides/locationservice-0000001050043283#section2628322193219)
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 是什么？

在预建中配置 @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 和提交记录判断。