使用HBuilder离线本地打包ipa教程

今人不见古时月,今月曾经照古人

已于 2022-08-04 15:12:21 修改

阅读量2.8k

点赞数

分类专栏： uni-app 文章标签： xcode ios macos

于 2022-08-04 15:05:00 首次发布

原文链接：https://cloud.tencent.com/developer/article/1946727

版权

uni-app 专栏收录该内容

34 篇文章 0 订阅

订阅专栏

开发环境

OS X 10.14.0+、Xcode 11.0+
HBuilderX下载
App离线SDK下载：最新iOS平台SDK下载
确保版本一致,请确保从HBuilderX导出的打包资源的HBuilderX的版本号和App离线SDK发布的版本号是一致的，如下2张图里的版本号：

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

SDK目录说明

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

详细说明:App离线SDK内不同文件的作用

配置工程

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

uni-app项目

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

5+app项目

如果您是5+app项目，为了减少ipa包的大小，可以相应的删除一些配置，可删除的配置如下：

库	js文件	其他
liblibWeex.a	weex-polyfill.js、uni-jsframework.js、weexUniJs.js、__uniappes6.js	unincomponents.ttf

配置应用标识(Boundle 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”节点，5+ APP项目在”plus”->”distribute”->”apple”->”privacyDescription”节点下可看到输入的内容：

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

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

如何配置多渠道

包名：对应xcode里的bundleid，如io.dcloud.HBuilder。

应用标识：对应5+或uni-app项目manifest.json中appid。

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

如何配置广告

如何配置广告？

如何配置3D Touch

配置3D Touch

如何配置IDFA

首先要知道：打开IDFA不影响AppStore审核如何知道项目中是否使用广告标示符，其实就是查看framework中是否有个叫AdSupport.framework的框架，如果检查工程中没有AdSupport.framework,可能是接入的第三方库里面有,用以下方法检查第三方中是否包含有IDFA版本：

1、打开终端cd到要检查的文件的目录;

2、执行命令:grep -r advertisingIdentifier . (注意别少了点);