uniapp info.plist 配置详解与常见问题

在uniapp开发iOS应用时，info.plist文件应该怎么配置？常见的配置项有哪些？

遇到需要添加隐私描述（如相机、相册权限）的情况，info.plist该怎么修改？

打包时出现info.plist相关错误（比如缺少关键配置项），有哪些排查方法和解决方案？

能否分享一个完整的info.plist配置示例，以及各个配置项的具体作用？

2 回复

UniApp的info.plist配置主要用于iOS平台权限和功能声明。常见配置项包括：

  1. 相机权限：NSCameraUsageDescription
  2. 相册权限：NSPhotoLibraryUsageDescription
  3. 定位权限：NSLocationWhenInUseUsageDescription

常见问题：

  1. 权限描述必须填写，否则审核被拒
  2. 配置后需重新打包生效
  3. 部分配置需配合manifest.json使用

建议在HBuilderX的manifest可视化界面配置，避免格式错误。


UniApp 的 info.plist 是 iOS 平台应用配置文件，用于设置应用权限、功能和元数据。以下是关键配置项和常见问题：

主要配置项

  1. 应用基本信息

    • CFBundleDisplayName：应用显示名称。
    • CFBundleIdentifier：应用唯一标识（Bundle ID）。
    • CFBundleVersion：应用版本号。

  2. 权限配置

    • 相机权限：
      <key>NSCameraUsageDescription</key>
<string>需要访问相机以拍摄照片或视频</string>
    • 相册权限：
      <key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册以选择图片</string>
    • 位置权限：
      <key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取位置以提供周边服务</string>

  3. URL Scheme（应用间跳转）

    <key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLName</key>
    <string>com.example.app</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>myapp</string>
    </array>
  </dict>
</array>

  4. 白名单（iOS 9+）

    <key>LSApplicationQueriesSchemes</key>
<array>
  <string>weixin</string>
  <string>alipay</string>
</array>

  5. iOS 14+ 相册限制

    <key>PHPhotoLibraryPreventAutomaticLimitedAccessAlert</key>
<true/>

常见问题与解决

  1. 权限描述被拒

    • 问题：上架 App Store 时因权限描述不清被拒绝。
    • 解决：在 info.plist 中填写具体用途，避免使用模糊描述。

  2. URL Scheme 不生效

    • 问题：其他应用无法通过 Scheme 跳转到本应用。
    • 解决：检查 CFBundleURLSchemes 是否配置正确，并确保目标应用已安装。

  3. 相册 Limited Mode 弹窗

    • 问题：iOS 14+ 频繁弹出相册限访问提示。
    • 解决：添加 PHPhotoLibraryPreventAutomaticLimitedAccessAlert 为 true，改为自定义相册管理。

  4. 配置未生效

    • 问题：修改 info.plist 后无效果。
    • 解决：清理项目并重新编译（HBuilderX：菜单 → 发行 → 原生App-云打包）。

注意事项

  • 所有权限描述（如 NSCameraUsageDescription）必须填写，否则提交审核会被拒。
  • 配置后需通过云打包或本地打包生成 IPA，真机调试时部分配置可能不生效。

通过正确配置 info.plist，可确保应用功能正常并符合 App Store 审核要求。

回到顶部