iOS离线打包

最新iOS平台App本地离线打包，请前往https://nativesupport.dcloud.net.cn/AppDocs/usesdk/ios

预备环境

iOS开发环境，Mac OS、XCode 7.2以上版本；
下载HBuilderX离线打包iOS版SDK（5+ SDK下载）。
注意：本文档基于XCode10 其他版本如有问题请留言
注意：如果离线打包的是uni-app项目请点击进入查看如何配置

SDK目录说明

HBuilder-Hello：离线打包演示应用；
Feature-iOS.xls：iOS平台各扩展Feature API对应的库文件列表；
Readme.txt：说明文件。

注意：HBuilder运行环境相关库文件已全部包含在HBuilder-Hello演示应用中

配置编译工程

从演示应用HBuilder-Hello创建工程

解压SDK包，进入目录HBuilder-Hello, 双击“HBuilder-Hello.xcodeproj”文件打开工程：
(建议不要将工程移出SDK目录，如需移动工程则要重新引入头文件和静态库文件到工程里)

- 配置应用标识(Bundle Identifier)

选择左侧“Project Navigator”中应用工程根目录，选中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打开的工程里的“基础配置”里的应用名称。如下图红色框所示：

2、如果需要配置国际化，在工程导航界面，选择InfoPlist.strings文件，修改CFBundleDisplayName值为应用名字:
InfoPlist.strings(English)为英文系统应用名,Simplified为中文简体系统应用名

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

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

- 配置应用图标和启动界面

第一种Launch Images Source方式

1、按下图所示，在配置的地方设置为空，这样配置之后启动界面就会是splash目录里配置的图了，就不会是LaunchScreen.storyboard 作为启动界面了。

2、演示工程中已经配置好了应用的图标和启动界面，只需要将对应的，符合要求的图片拷贝到对应工程里的icon和splash目录即可：

第二种Launch Screen File方式

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

2、制作LaunchScreen.storyboard(这个storyboard的名称是可以自定义的)，如果想自定义LaunchScreen.storyboard，这需要你会原生知识，知道怎样创建Launch Screen File，知道怎样在storyboard中布局视图，设置约束等。如果不想自定义，可以使用官方已经制作好的storyboard，官方提供了2个storyboard，一个是图标、名称在上方的；另外一个是图标、名称在下方的。
注意：在使用Launch Screen File方式作为启动界面时，需要把一张或几张清晰的图标拷贝到app.imageset文件夹下，用来给启动界面加载图标。如果拷贝过去的图标不清晰会导致启动界面上的图标不清晰、模糊的现象出现。

- 更新应用资源

注意:Pandora目录为folder references引入方式，修改后不会自动更新,需要在模拟器或设备删除应用后再重新运行  
注意:拷贝到Pandora目录的www目录中manifest.json需要删除注释

如何从HBuilderX中导出应用资源请参考:HBilderX生成本地打包App资源

打开pandora -> apps 目录，将下面“HelloH5”目录名称修改为应用manifest.json中的id字段值，uni-app项目为manifest.json中的appid字段值（这步非常重要，否则会导致应用无法正常启动），并将所有应用资源拷贝到其下的www目录中：

- 配置应用信息

打开工程目录下的control.xml文件，修改appid值：

其中appid值为HBuilder应用的appid，必须与应用manifest.json中的id字段值（uni-app项目为manifest.json中的appid字段值）完全一致；appver为应用的版本号，用于应用资源的升级，必须保持与manifest.json中的version -> name值完全一致；version值为应用基座版本号（plus.runtime.innerVersion返回的值），不要随意修改。

- 配置应用使用的5+功能模块（可选）

演示应用中已经引用HBuilder所有扩展的5+ API功能模块，如果在应用中没有使用到，为了减少发布时安装包的大小可以删除不使用的模块。按下图打开链接库文件配置列表：

在“Feature-iOS.xls”文件中查找不使用模块对应的“LinkerFlags”，从列表中删除。
如不使用“相机模块”，则可选中“liblibCamera.a”、按退格键删除(按option键可以多选)：

- 配置第三方库的参数

如果用到使用第三方库的功能模块（如推送、分享、语音识别、统计），则需要通过“Feature-iOS.xls”文件中查找对应模块的“Info”值，并在工程属性界面“Info”下“Custom iOS Target Properties”中找到对应的项配置：

如百度地图，需要配置在百度云平台申请应用的appkey，找到“baidu”项下的“appkey”，双击后输入正确的appkey值：

注意：新浪微博和微信分享还需要配置应用的URL Schemes，在“URL Types”项下分别输入在各开放平台申请的值：

配置完成编译运行

应用配置完毕，在模拟器上编译运行应用：

正确编译后启动模拟器并运行：

如何配置多渠道和广告

注意：如果要配置广告，需要2个步骤：
1.在info.plist文件里加DCLOUD_AD_ID节点，内容为自己申请的广告adid
2.把marketChannel节点的广告标识换成申请的广告标识。如下图所示：

如何关闭广告

5+SDK里默认打开了开屏广告，用户如果不需要开屏广告可在Appdelegate.m文件中注释如下部分，并删除ad库文件,即可关闭广告

// 示例默认带开屏广告，如果不需要广告，可注释下面一行,  
#define ENABLEAD

如果需要关闭其他类型的广告可在应用的manifest.json文件中增加如下配置

    "plus": {  
        "ads": {  
            "push":"false",       
            "splash":"false",     
            "rp":"false",          
            "spot":"false",       
        }  
    }

说明可参考文档 Manifest.json文档说明 manifest配置ads部分

如何配置3D Touch

配置3D Touch

如何配置IDFA

首先要知道：打开IDFA不影响AppStore审核
如何知道项目中是否使用广告标示符，其实就是查看framework中是否有个叫AdSupport.framework的框架，如果检查工程中没有AdSupport.framework,可能是接入的第三方库里面有,用以下方法检查第三方中是否包含有IDFA版本：
(1)打开终端cd到要检查的文件的目录;
(2)执行命令:grep -r advertisingIdentifier . (注意别少了点);
iOS平台配置应用使用广告标识（IDFA）