Uniapp开发iOS应用获取系统权限完整教程

最新推荐文章于 2026-02-27 00:05:52 发布

原创最新推荐文章于 2026-02-27 00:05:52 发布 · 1.2k 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#uniapp #ios

前端专栏收录该内容

122 篇文章

订阅专栏

在Uniapp开发iOS应用时，获取系统权限（如相机、相册、定位等）是常见需求。由于iOS系统对隐私权限管理严格，需要在代码和配置文件中正确设置。以下是完整的实现步骤和注意事项。

一、权限类型与对应API

Uniapp通过uni.authorize、uni.getSetting等API进行权限管理，同时需要配合manifest.json配置和iOS原生配置。

权限类型	对应API	使用场景
相机	`uni.authorize({scope: 'camera'})`	扫码、拍照
相册	`uni.authorize({scope: 'writePhotosAlbum'})`	保存图片到相册
定位	`uni.authorize({scope: 'userLocation'})`	获取地理位置
通知	`uni.authorize({scope: 'notification'})`	推送通知
蓝牙	`uni.authorize({scope: 'bluetooth'})`	蓝牙设备连接

二、基础权限申请流程

1. 在manifest.json中配置权限

首先需要在HBuilderX中打开项目的manifest.json文件，在"App权限配置"中勾选所需权限：

{
  "app-plus": {
    "distribute": {
      "apple": {
        "permissions": {
          "camera": {
            "description": "用于扫码和拍照"
          },
          "photos": {
            "description": "用于访问相册"
          },
          "location": {
            "description": "用于获取位置信息"
          }
        }
      }
    }
  }
}

注意：配置后需要重新打包才能生效。

2. 代码中动态申请权限

使用Uniapp的权限API进行动态申请：

// 检查权限状态
uni.getSetting({
  success(res) {
    if (!res.authSetting['scope.camera']) {
      // 未授权，发起授权请求
      uni.authorize({
        scope: 'camera',
        success() {
          console.log('相机权限授权成功')
        },
        fail() {
          console.log('相机权限授权失败')
          // 引导用户手动开启
          uni.showModal({
            title: '提示',
            content: '需要开启相机权限才能使用扫码功能',
            success(res) {
              if (res.confirm) {
                // 跳转到系统设置页
                uni.openSetting()
              }
            }
          })
        }
      })
    }
  }
})

3. 直接使用API时的权限处理

部分API（如uni.chooseImage）会自动触发权限申请，但需要处理拒绝后的情况：

uni.chooseImage({
  count: 1,
  success(res) {
    console.log('选择图片成功', res.tempFilePaths)
  },
  fail(err) {
    if (err.errMsg.indexOf('auth deny') !== -1) {
      // 权限被拒绝，引导用户开启
      uni.showModal({
        title: '提示',
        content: '需要相册权限才能选择图片',
        success(res) {
          if (res.confirm) {
            uni.openSetting()
          }
        }
      })
    }
  }
})

三、iOS原生配置（重要）

1. 配置Info.plist权限描述

在HBuilderX中，需要为iOS平台添加权限描述信息。在manifest.json的"App模块权限配置"中，找到iOS模块配置：

{
  "app-plus": {
    "distribute": {
      "apple": {
        "infoPlist": {
          "NSPhotoLibraryUsageDescription": "需要访问您的相册以选择图片",
          "NSCameraUsageDescription": "需要访问您的相机以进行扫码和拍照",
          "NSLocationWhenInUseUsageDescription": "需要获取您的位置以提供更好的服务",
          "NSLocationAlwaysUsageDescription": "需要持续获取位置以提供后台服务"
        }
      }
    }
  }
}

关键说明：

这些描述文字会显示在系统权限弹窗中，必须清晰说明用途
如果未配置，iOS审核可能被拒
描述文字需要符合实际功能

2. 后台模式配置（如需要）

如果应用需要在后台使用定位或音频，需要在manifest.json中配置：

{
  "app-plus": {
    "distribute": {
      "apple": {
        "UIBackgroundModes": [
          "location",
          "audio"
        ]
      }
    }
  }
}

四、常见权限类型详细实现

1. 相机权限

完整示例代码：

// 检查并申请相机权限
function checkCameraPermission() {
  return new Promise((resolve, reject) => {
    uni.getSetting({
      success(res) {
        if (res.authSetting['scope.camera']) {
          resolve(true)
        } else {
          uni.authorize({
            scope: 'camera',
            success() {
              resolve(true)
            },
            fail() {
              // 用户拒绝，引导开启
              uni.showModal({
                title: '提示',
                content: '需要相机权限才能使用扫码功能',
                success(modalRes) {
                  if (modalRes.confirm) {
                    uni.openSetting()
                  }
                  resolve(false)
                }
              })
            }
          })
        }
      }
    })
  })
}

// 使用示例
async function scanQRCode() {
  const hasPermission = await checkCameraPermission()
  if (hasPermission) {
    uni.scanCode({
      success(res) {
        console.log('扫码结果:', res.result)
      }
    })
  }
}

2. 相册权限

相册权限分为读取和写入两种，Uniapp中对应scope.writePhotosAlbum：

// 保存图片到相册
function saveImageToAlbum(tempFilePath) {
  uni.saveImageToPhotosAlbum({
    filePath: tempFilePath,
    success() {
      uni.showToast({ title: '保存成功' })
    },
    fail(err) {
      if (err.errMsg.indexOf('auth deny') !== -1) {
        uni.showModal({
          title: '提示',
          content: '需要相册权限才能保存图片',
          success(res) {
            if (res.confirm) {
              uni.openSetting()
            }
          }
        })
      }
    }
  })
}

3. 定位权限

定位权限需要特别注意，iOS有"使用时"和"始终"两种模式：

// 获取定位权限
function getLocationPermission() {
  uni.authorize({
    scope: 'userLocation',
    success() {
      // 获取位置
      uni.getLocation({
        type: 'wgs84',
        success(res) {
          console.log('位置信息:', res)
        }
      })
    },
    fail() {
      uni.showModal({
        title: '提示',
        content: '需要位置权限才能获取定位',
        success(res) {
          if (res.confirm) {
            uni.openSetting()
          }
        }
      })
    }
  })
}

五、权限状态管理

1. 检查所有权限状态

uni.getSetting({
  success(res) {
    const authSetting = res.authSetting
    console.log('相机权限:', authSetting['scope.camera'])
    console.log('相册权限:', authSetting['scope.writePhotosAlbum'])
    console.log('定位权限:', authSetting['scope.userLocation'])
  }
})

2. 监听权限变化

iOS系统允许用户在设置中随时关闭权限，应用需要监听变化：

// 在App.vue的onShow中监听
export default {
  onShow() {
    // 检查权限状态，如果被关闭则提示
    this.checkPermissions()
  },
  methods: {
    checkPermissions() {
      uni.getSetting({
        success(res) {
          if (!res.authSetting['scope.camera']) {
            // 相机权限被关闭，提示用户
          }
        }
      })
    }
  }
}