從 iOS 10 開始,只要 App 會存取隱私資料——相機、相簿、麥克風、定位、聯絡人、日曆等等——就必須在 Info.plist 中提供對應的用途說明字串。缺少對應的 key,App 在觸發該功能時會直接崩潰,而不是給個提示而已。
解法
在 Info.plist 的 Source Code 模式下加入對應的 Usage Description。描述文字可以自行撰寫,但一定要填,而且不能留空字串,否則可能導致打包後的構建版本一直無法顯示。
<!-- 相簿 --> <key>NSPhotoLibraryUsageDescription</key> <string>App需要您的同意,才能訪問相冊</string> <!-- 相機 --> <key>NSCameraUsageDescription</key> <string>App需要您的同意,才能訪問相機</string> <!-- 麥克風 --> <key>NSMicrophoneUsageDescription</key> <string>App需要您的同意,才能訪問麥克風</string> <!-- 定位(使用前說明) --> <key>NSLocationUsageDescription</key> <string>App需要您的同意,才能訪問位置</string> <!-- 使用期間允許定位 --> <key>NSLocationWhenInUseUsageDescription</key> <string>App需要您的同意,才能在使用期間訪問位置</string> <!-- 永遠允許定位 --> <key>NSLocationAlwaysUsageDescription</key> <string>App需要您的同意,才能始終訪問位置</string> <!-- 日曆 --> <key>NSCalendarsUsageDescription</key> <string>App需要您的同意,才能訪問日歷</string> <!-- 提醒事項 --> <key>NSRemindersUsageDescription</key> <string>App需要您的同意,才能訪問提醒事項</string> <!-- 運動與健身 --> <key>NSMotionUsageDescription</key> <string>App需要您的同意,才能訪問運動與健身</string> <!-- 健康更新 --> <key>NSHealthUpdateUsageDescription</key> <string>App需要您的同意,才能訪問健康更新</string> <!-- 健康分享 --> <key>NSHealthShareUsageDescription</key> <string>App需要您的同意,才能訪問健康分享</string> <!-- 藍牙 --> <key>NSBluetoothPeripheralUsageDescription</key> <string>App需要您的同意,才能訪問藍牙</string> <!-- 媒體資料庫 --> <key>NSAppleMusicUsageDescription</key> <string>App需要您的同意,才能訪問媒體資料庫</string>
需要後台能力時
若 App 需要在後台持續使用某些能力(例如後台定位),還要額外在 UIBackgroundModes 中宣告:
<key>UIBackgroundModes</key>
<array>
<!-- 寫上後台模式對應的 identifier -->
<string>location</string>
</array>
幾點補充說明
第一,NSLocationUsageDescription 在 iOS 11 之後已被廢棄,現在只保留 NSLocationWhenInUseUsageDescription 與 NSLocationAlwaysAndWhenInUseUsageDescription 這兩種模式,新專案不必再補舊 key。
第二,iOS 14 起存取相簿需要區分「完整存取」與「僅選取的照片」,前者對應 NSPhotoLibraryUsageDescription,後者為 NSPhotoLibraryAddUsageDescription(僅寫入)。
第三,這些字串不是法律條文,而是直接顯示在系統彈窗上給使用者看的。撰寫時應該具體說明「用來做什麼」,例如「用於掃描發票並存入您的帳單」,而不是空泛地寫「需要訪問相機」。審核被拒的案例中,用途說明過於模糊是很常見的原因。