简体中文
app打包,在iOS原生开发中提供了配置 Info.plist 和 资源文件(Bundle Resources)。uni-app中对常用项进行了封装,提供了manifest.json。
但manifest.json不能包含所有iOS的配置。
在HBuilderX 3.6.5以前,开发者如需使用manifest未封装的配置、或需自定义资源文件(Bundle Resources)内容,只能离线打包或开发App原生语言插件。
HBuilderX3.6.5起,支持直接在应用项目中配置 iOS 平台的 Info.plist 和 资源文件(Bundle Resources)。
在HBuilderX中,对项目根目录右键菜单 "新建" -> "自定义文件"
输入文件名称 Info.plist
(注意大小写敏感),点击 “创建” 按钮新建文件
根据应用需求编辑添加需要的内容,如下示例:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>My_Custom_String_Key</key>
<string>My_Custom_String_Value</string>
<key>My_Custom_Array_Key</key>
<array>
<dict>
<key>My_Custom_Array_Item_Key</key>
<string>My_Custom_Array_Item_Value</string>
<key>My_Custom_Array_Item_Key2</key>
<string>My_Custom_Array_Item_Value2</string>
</dict>
</array>
</dict>
</plist>
注意
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
如果应用需要修改隐私信息访问的许可描述,可根据需求在Info.plist
文件中添加,如下示例:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSPhotoLibraryUsageDescription</key>
<string>读取相册的许可描述</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>读写相册的许可描述</string>
<key>NSCameraUsageDescription</key>
<string>使用摄像头的许可描述</string>
<key>NSMicrophoneUsageDescription</key>
<string>使用麦克风的许可描述</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>运行期访问位置信息的许可描述</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>后台运行期访问位置信息的许可描述</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>访问位置信息的许可描述</string>
<key>NSCalendarsUsageDescription</key>
<string>访问日历的许可描述</string>
<key>NSContactsUsageDescription</key>
<string>访问通讯录的许可描述</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>使用蓝牙的许可描述</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>持续使用蓝牙的许可描述</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>使用系统语音识别的许可描述</string>
<key>NSRemindersUsageDescription</key>
<string>访问提醒事项的许可描述</string>
<key>NSMotionUsageDescription</key>
<string>访问运动与健身的许可描述</string>
<key>NSHealthUpdateUsageDescription</key>
<string>更新健康数据的许可描述</string>
<key>NSHealthShareUsageDescription</key>
<string>分享健康数据的许可描述</string>
<key>NSAppleMusicUsageDescription</key>
<string>访问媒体资料库的许可描述</string>
<key>NFCReaderUsageDescription</key>
<string>使用NFC的许可描述</string>
<key>NSHealthClinicalHealthRecordsShareUsageDescription</key>
<string>访问临床记录信息的许可描述</string>
<key>NSHomeKitUsageDescription</key>
<string>访问HomeKit数据的许可描述</string>
<key>NSSiriUsageDescription</key>
<string>访问Siri的许可描述</string>
<key>NSFaceIDUsageDescription</key>
<string>使用FaceID的许可描述</string>
<key>NSLocalNetworkUsageDescription</key>
<string>使用本地网络的许可描述</string>
<key>NSUserTrackingUsageDescription</key>
<string>跟踪用户活动的许可描述</string>
</dict>
</plist>
注意
uni-app x项目manifest.json中没有提供iOS隐私信息访问许可描述的配置,需在此Info.plist中添加。
配置许可描述时需根据应用实际情况准确描述用途,否则提交AppStore审核可能被拒。
相关参考
HBuilderX中对项目右键菜单 "新建" -> "目录"
输入名称 nativeResources
(注意大小写敏感),确定并创建目录。
继续创建“ios”子目录、创建“Resources”二级子目录,结构如下:
将需要添加的iOS原生资源文件拷贝到Resources目录,云端打包时将会合并到安装包的.app中。
注意
┌─Pandora //uni-app资源目录
│ └─apps //应用资源目录
│ └─[AppID] //使用DCloud AppID作为目录名称
├─PandoraApi.bundle //uni-app SDK内置资源目录
├─control.xml //uni-app模块配置文件
├─dcloud_logo@2x.png //应用logo图片
├─dcloud_logo@3x.png //应用logo图片
├─uni-jsframework.js //uni-app vue2框架
├─uni-jsframework-vue3.js //uni-app vue3框架
├─uni-jsframework-dev.js //uni-app vue2框架(开发模式)
├─uni-jsframework-vue3-dev.js //uni-app vue3框架(开发模式)
├─unincomponents.ttf //uni-app内置字体图标
└─userPosition@2x.png //地图模块当前位置图标
离线打包时应用清单文件和资源需要开发者手动合并到XCode原生工程中。