# 开发环境

  • 安装 Xcode 15 及以上版本
  • HBuilderX下载
  • App离线SDK下载:最新iOS平台SDK下载
  • 确保版本一致,请确保从HBuilderX导出的打包资源的HBuilderX的版本号和App离线SDK发布的版本号是一致的,如下2张图里的版本号:

注意:如果版本不一致,app启动时会弹出版本不一致的提示框,并且可能导致功能异常

注意:3.1.10版本起需要申请Appkey,具体请点击链接

# SDK目录说明

    |-- HBuilder-Hello       给用户打uni-app项目的离线打包工程
    |-- Feature-iOS.xls      配置表(依赖的库、资源文件、参数配置等)
    |-- SDK                 工程需要的库文件,.h头文件,配置文件,资源文件

# 配置工程

  找到App离线SDK压缩包,并解压,再进入目录;找到HBuilder-Hello文件夹,并打开原生工程,然后准备配置工程。

# uni-app项目

  App离线SDK中的HBuilder-Hello文件夹下的打包工程 是按照uni-app项目来配置的,所以基础配置不需要动。

# 配置Appkey

3.1.10版本起需要申请 Appkey,申请请 参考

打开info.plist,创建key为dcloud_appkey,Value选择String类型,内容为申请的AppKey如下:

**注意:**需要按照下面的教程将 「应用标识」以及 导入资源教程「control.xml 中对应的 appid」 修改为正确的值,否则运行时会还是会提示 appkey 错误;

# 配置应用标识(Bundle Identifier)

选择左侧应用工程根目录,选中TARGETS下的HBuilder打开工程属性界面,在General下修改Identity的值:

其中,Bundle Identifier为苹果的AppID,必须与应用发布时配置的Profile关联的AppID一致;

Version为应用版本号,在App Store中显示的版本号,推荐与manifest.json中version下的name值一致;

Build为编译版本号,App Store判断升级使用,推荐与manifest.json中version下的code值一致。

# 配置应用名称

1、在打开的原生工程中,点击工程的targets和点开manifest文件,然后将manifest文件里的“name”字段的内容 和原生工程里的Display Name 的写成一样。

注意,manifest文件里的”name“ 对应的是HBuilderX打开的工程里的“基础配置”里的应用名称。如下图红色框所示:

# 配置应用版本名称

在打开的原生工程中,点击工程的targets和点开manifest文件,然后将manifest文件里的“version”字段里的“name”的内容 和原生工程里的Version 的写成一样。注意,manifest文件里的“version”字段里的“name” 对应的是HBuilderX打开的工程里的“基础配置”里的应用版本名称。如下图红色框所示:

# 配置应用版本号

在打开的原生工程中,点击工程的targets和点开工程里的manifest文件,然后将manifest文件里的“version”字段里的“code”的内容 和原生工程里的Build 的写成一样。注意,manifest文件里的“version”字段里的“code” 对应的是HBuilderX打开的工程里的“基础配置”里的应用版本号。如下图红色框所示:

# 配置应用的图标

点击project->target->General->App Icons and Launch Images->App Icons Source项右侧小箭头 在新开页面根据提示将对应尺寸的应用图标拖入到虚线框中即可

# 配置应用启动界面

1、按下图方法配置Launch Screen File,这样配置之后启动界面就会是设置的LaunchScreen.storyboard。

2、使用官方已经制作好的storyboard,官方提供了2个storyboard,一个是图标、名称在上方的;另外一个是图标、名称在下方的(这种的LaunchScreen.storyboard主要是适配用户配置广告后,使其启动时不会有视觉上的跳跃感,增加用户体验)。 注意:在使用Launch Screen File方式作为启动界面时,需要把一张或几张清晰的图标拷贝到工程的根文件夹下并引入到工程中, 用来给启动界面加载图标。如果拷贝过去的图标不清晰,会导致启动界面上出现图标不清晰、模糊的现象。

3、制作LaunchScreen.storyboard(这个storyboard的名称是可以自定义的),如果想自定义LaunchScreen.storyboard, 这需要你会原生知识,知道怎样创建Launch Screen File,知道怎样在storyboard中布局视图,设置约束等。

 注意,这里的storyboard,不是普通的storyboard;
 注意,配置了广告之后,如果自定义的LaunchScreen.storyboard约束没设置好,会有启动页到广告页跳跃的视觉效果。

# 配置国际化,有2部分:

第一部分:内容相关的国际化,离线打包时如果弹出提示框且内容为:“HTML5+ Rumtime D”时,需要在打包的原生工程里配置国际化如何配置

第二部分:Info.plist的国际化,新建一个 .strings文件,叫做InfoPlist.strings(文件名必须是这个)然后点击右侧的 localized, 再在工程导航界面,选择InfoPlist.strings文件,比如添加key为CFBundleDisplayName,值为应用名字(HBuilder你好),InfoPlist.strings(English)为英文系统,Simplified为中文简体系统

另外,对HBuilderX,manifest.json文件里,“模块权限配置”项中的“iOS隐私信息访问的许可描述”栏下的隐私权限描述国际化,可以这样配置,如下:

1、将manifest.json页面切换到“模块权限配置”项,在“iOS隐私信息访问的许可描述”栏下配置应用需要使用到的隐私描述信息:

2、输入完成后切换到代码视图,uni-app项目在"app-plus"->"distribute"->"ios"->"privacyDescription"节点下可看到输入的内容:

3、将"privacyDescription"节点下的key(NSPhotoLibraryUsageDescription)和值按下图的方式拷贝到InfoPlist.strings下对应的语言文件里去。

完整可配置的隐私项可参考苹果官网中以“NS”开头、“Description”结尾的项。

# 如何配置多渠道

在需要的打包的原生工程中找到工程的配置文件-Info.plist ,然后添加marketChannel节点,节点内容格式为:包名|应用标识|广告标识|渠道 如io.dcloud.HB|appid|adid|apple

包名:对应xcode里的bundleid,如io.dcloud.HBuilder。

应用标识:对应uni-app项目manifest.json中appid。

广告标识:DCloud的广告标识,开通广告后可在dev.dcloud.net.cn获取,如果没有开通广告,设置值为空即可。 渠道:可以填apple。

# 如何配置暗黑模式

  1. 在需要的打包的原生工程中找到工程的配置文件-Info.plist,移除UIUserInterfaceStyle节点(若不想支持暗夜模式,添加该节点并将该节点的值修改为Light或Dark即可,其中Light为始终显示默认高亮模式,Dark为始终显示暗夜模式,值为String类型)
  2. 如需设置启动时的默认模式,在上述Info.plist文件中添加DCloudConfig节点(如已有无需再次添加,节点类型为Dictionary),在该节点下添加defaultTheme节点(值类型为String),根据需求添加light(高亮)、dark(暗夜)、auto(跟随系统)即可

# 如何配置广告

如何配置广告

# 如何配置3D Touch

配置3D Touch

# 如何配置IDFA

# 如果您的应用符合下面其中一条就需要配置 IDFA ,反之可以不配置
  • 只要您的应用使用了uni-AD广告模块,就需要开启 IDFA;
  • 使用的 离线SDK 版本低于 3.2.15 并且应用使用了新浪微博登录和分享、一键登录、友盟统计 其中一个或多个功能模块,这些SDK内会触发获取IDFA,所以需要开启 IDFA (注:HX 3.2.15及以上版本更新了这些三方SDK,不在获取IDFA)

1、在工程 TARGETS->Build Phases-> Link Binary With Libaries 中点击“+”按钮,在弹出的窗口中点击 Add Other -> Add Files...,将 “SDK/Resources/Libs” 中的 liblibAdSupport.aAppTrackingTransparency.framework(系统库) 添加到工程中,注意 AppTrackingTransparency.framework 的 Status 选择 Optional ,如下图所示

2、在工程的 info.plist 中添加 NSUserTrackingUsageDescription 权限描述,详情请参考 iOS平台配置应用使用广告标识(IDFA) 中的说明填写;

3、开启广告标识(IDFA)后,提交App Store审核之前,需要在App Store Connect 配置 “App 隐私”,详情请参考iOS平台配置应用使用广告标识(IDFA) 中的说明;

# 如何配置启动时是否注册Push

1、如果希望在应用启动时不弹出"发送通知"系统授权框,可以不向系统注册要使用消息推送功能,配置方法如下: 找到工程里的info.plist文件,然后配置dcloud_push_register_mode字段,值为manual。

2、如果希望在应用启动时弹出"发送通知"系统授权框,不需要做任何配置。

iOS平台隐私与政策提示框实现注意问题

# 如何配置iOS平台的某些较特殊的功能

平台功能配置

# 如何处理提交审核时提示有其他支付并隐藏功能被拒的问题

点击处理办法

# 如何用离线打包工程制作自定义调试基座

1、在打包原生工程里找到 control.xml文件,在HBuilder节点里查看是否有这2个: debug="true" syncDebug="true" 配置(注意-打AppStore包的时候,这个配置需要去掉,否则会导致热更新失败!),没有的话增加上,然后保存。

2、 确保Xcode工程的Bundle identifier不为 io.dcloud.HBuidler。

3、在原生工程里找到info.plist文件并增加一项,如下图:

4、确保原生工程里Pandora文件夹下的apps文件夹里只有一个文件夹(文件夹的名称和里面的manifest的id值相同)

5、确保control.xml文件里的appid的值和apps目录下的第一个文件夹的名称一致

6、确保HBuilderX里要调试的代码的appid和control.xml的appid值一致

7、使用Xcode的Product下的archive 打包,然后生成ipa,并把ipa名称命名为:iOS_debug.ipa

8、在js工程里主目录下新建一个名称为unpackage的文件夹(如果有不用新建),再在unpackage文件夹下新建一个名称为debug文件夹,并把生成的iOS_debug.ipa包放入debug文件夹。

9、在HBuildX里,找到之前appid相同的js工程准备调试,点击“运行” --“运行到手机或模拟器“--“使用自定义基座运行(iOS)”,等待连接成功之后就可以了。

# 隐私清单

SDK 4.13之后的版本在示例工程中包含基础模块的隐私清单,4.13之前版本也可以直接用4.13的隐私清单 基础模块隐私清单如下所示: 基础模块隐私清单

集成uni-AD模块以及统计模块需要根据该模块的文档补充填写隐私清单

# uts插件

注意:需要HBuilder X 4.18版本及以上。 如果uni-app项目包括uts原生插件,资源导出之后会在resources目录下新增uni_modules目录。参考:

# 添加uts依赖

工程添加依赖库DCUniBase.framework(Embed & Sign)DCloudUTSFoundation.framework(Embed & Sign),并将liblibPDRCore.aliblibWeex.a从工程移除

# 配置uts插件

uts原生插件制作及导入参考UTS插件文档,将uts插件添加到项目工程中。

# 运行

连接手机,编译运行,如果App成功跑起来了,说明原生工程配置完成。