uniapp项目报错getLocation:fail the api need to be declared in the requiredPrivateInfos field in app.json/ext.json

### 解决 UniApp 中 `getLocation` 接口调用失败的方法

在开发过程中遇到 `uni.getLocation()` 调用失败的情况，通常是因为应用缺少必要的权限声明。为了使该 API 正常工作，需确保应用程序已正确配置所需的隐私权限。

对于 iOS 和 Android 平台，应在项目的配置文件中适当位置添加 `requiredPrivateInfos` 字段以请求访问设备的位置信息[^1]。

#### 配置方法：

##### 对于 HBuilderX 创建的项目 (app.vue 或 main.js)

如果使用的是基于 Vue 的单页面模板，则可以在 `manifest.json` 文件中的 `"app-plus"` 下定义所需权限:

{
  "app-plus": {
    ...
    "distribute": {
      "ios": {
        "privacy": [
          "location-always",
          "location-when-in-use"
        ]
      },
      "android": {
        "permissions": [
          "ACCESS_FINE_LOCATION",
          "ACCESS_COARSE_LOCATION"
        ]
      }
    }
  }
}

##### 使用 ext.config.js 进行扩展配置

当需要更灵活地管理不同环境下的配置时，可以利用外部配置文件 `ext.config.js` 来补充或覆盖默认设置。在此文件内同样指定 `requiredPrivateInfos` 参数如下所示：

module.exports = {
  appplus: {
    distribute: {
      ios: {
        privacy: ['location-always', 'location-when-in-use']
      },
      android: {
        permissions: ["ACCESS_FINE_LOCATION", "ACCESS_COARSE_LOCATION"]
      }
    }
  }
};

完成上述修改之后重新编译并部署应用程序，此时应该能够成功调用 `uni.getLocation()` 方法而不再报错。