uni-app IOS使用罗盘功能时打包后调用API提示"打包时未添加Orientation模块"。此模块并不存在

开发环境	版本号	项目创建方式
PC开发环境操作系统	Windows	HBuilderX
PC开发环境操作系统版本号	win11	-
手机系统	iOS	-
手机系统版本号	iOS 17	-
手机厂商	苹果	-
手机机型	Xr	-
页面类型	vue	-
vue版本	vue2	-
打包方式	云端	-

示例代码：

【报Bug】IOS使用罗盘功能时，打包后调用API提示"打包时未添加Orientation模块"。此模块在manifest.json权限页面并不存在相关权限勾选项

操作步骤：

【报Bug】IOS使用罗盘功能时，打包后调用API提示"打包时未添加Orientation模块"。此模块在manifest.json权限页面并不存在相关权限勾选项

预期结果：

【报Bug】IOS使用罗盘功能时，打包后调用API提示"打包时未添加Orientation模块"。此模块在manifest.json权限页面并不存在相关权限勾选项

实际结果：

【报Bug】IOS使用罗盘功能时，打包后调用API提示"打包时未添加Orientation模块"。此模块在manifest.json权限页面并不存在相关权限勾选项

bug描述：

【报Bug】IOS使用罗盘功能时，打包后调用API提示"打包时未添加Orientation模块"。此模块在manifest.json权限页面并不存在相关权限勾选项

songsunli 1楼•18 天前

https://uniapp.dcloud.net.cn/tutorial/app-modules.html#注意事项，参考文档manifest.json 中添加权限 “app-plus” : {
“modules” : {
“Orientation”: {
“description”: “传感器”
}
}
}

gougou168 2楼•18 天前

在使用 uni-app 开发 iOS 应用时，如果你调用罗盘功能（如 uni.onCompassChange）时遇到提示“打包时未添加 Orientation 模块”，可能是由于 uni-app 的某些配置或模块缺失导致的。以下是一些可能的解决方案：

1. 检查 manifest.json 配置

在 manifest.json 文件中，确保你已经正确配置了相关的模块和权限。特别是 iOS 平台的相关配置。

{
  "app-plus": {
    "modules": {
      "Orientation": {}
    },
    "distribute": {
      "ios": {
        "UIRequiresFullScreen": true,
        "UIBackgroundModes": ["location", "fetch"]
      }
    }
  }
}

2. 使用 HBuilderX 打包

确保你使用的是最新版本的 HBuilderX 进行打包。旧版本可能存在一些模块缺失或配置问题。

3. 检查原生模块

如果你使用的是原生插件或模块，确保这些模块已经正确配置并且能够在 iOS 平台上正常工作。

4. 手动添加模块

如果 Orientation 模块确实不存在，你可以尝试手动添加相关的原生代码或插件来实现罗盘功能。你可以使用 cordova-plugin-device-orientation 或其他类似的插件。

5. 使用其他 API

如果 uni.onCompassChange 无法正常工作，可以尝试使用其他 API 或插件来实现罗盘功能，例如 cordova-plugin-device-orientation。

6. 检查权限

确保你的应用已经获取了必要的权限，特别是在 iOS 平台上，需要在 Info.plist 文件中添加相应的权限描述。

<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要使用您的位置信息来提供罗盘功能</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>我们需要使用您的位置信息来提供罗盘功能</string>