DCloud_App_Array
DCloud_App_Array
  • 发布:2014-08-02 23:32
  • 更新:2024-06-12 19:22
  • 阅读:609735

iOS离线打包

分类:HTML5+

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


预备环境

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”项下分别输入在各开放平台申请的值:

配置完成编译运行

应用配置完毕,在模拟器上编译运行应用:

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

如何配置多渠道和广告

在需要的打包的原生工程中找到工程的配置文件-Info.plist ,然后添加marketChannel节点,节点内容格式为:包名|应用标识|广告标识|渠道 如io.dcloud.HB|appid|adid|apple
包名:对应xcode里的bundleid,如io.dcloud.HBuilder。
应用标识:对应5+或uni-app项目manifest.json中appid。
广告标识:DCloud的广告标识,开通广告后可在dev.dcloud.net.cn获取,如果没有开通广告,设置值为空即可。
渠道:可以填apple。

注意:如果要配置广告,需要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)

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

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

提交审核时提示有其他支付并隐藏功能被拒的处理办法

点击处理办法

Android平台请参考Android离线打包

17 关注 分享
jwenlee hellojh 大虫 sbin ___K Jino_Yang MR不靠谱 chuyin 五叶神 4***@qq.com Bu忘初心_ 2***@qq.com 赵庆桥 1***@qq.com 3***@qq.com k***@qq.com d***@126.com

要回复文章请先登录注册

7***@qq.com

7***@qq.com

回复 1***@163.com :
arm架构的mac在xcode中配置 Build Settings,User-Defined -> VLID_ARCHS 删除arm64,亲测有效
2023-05-25 14:06
1***@163.com

1***@163.com

请问,按上面配置好后,允许报以下错误
In ../SDK/libs/libuchardet.a(LangLithuanianModel.o), building for iOS Simulator, but linking in object file built for iOS, file '../SDK/libs/libuchardet.a' for architecture arm64
2023-03-27 15:47
7***@qq.com

7***@qq.com

ios打包报错:"_OBJC_CLASS_$_KSCrashReportFilterAppleFmt", referenced from:
objc-class-ref in liblibPDRCore.a(H5CoreExceptionHandler.o)
"_OBJC_CLASS_$_KSCrash", referenced from:
objc-class-ref in liblibPDRCore.a(H5CoreExceptionHandler.o)
"_OBJC_CLASS_$_KSCrashInstallationStandard", referenced from:
objc-class-ref in liblibPDRCore.a(H5CoreExceptionHandler.o)
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)
2022-08-04 10:30
s***@126.com

s***@126.com

回复 bigpaul :
如何解决的
2022-04-21 11:43
bigpaul

bigpaul

一直说未添加OAuth模块怎么解决
2021-12-06 19:53
missfei

missfei

回复 missfei :
xcode 13.2
2021-11-11 11:20
missfei

missfei

新版本的 xcode 不能运行默认项目,会报错
2021-11-11 11:11
1***@qq.com

1***@qq.com

Signing for "HBuilder" requires a development team. Select a development team in the Signing & Capabilities editor. 这是什么情况 然我选择开发团队 选了说冲突 已自动签名
2021-03-29 19:51
顺丰啊

顺丰啊

因为我的插件需要调用到第三方SDK,然后第三方SDK又有调用另一个第三方SDK的api,导致在云打包过程中,第三方在调用另一个第三方sdk的时候,出问题了, 但是在我本地Xcode运行是正常的,
2020-11-07 11:30
顺丰啊

顺丰啊

作者你好,我是iOS开发原生插件的,现在遇到一个问题,就是我在xcode工程下按照你们配置的第三方如下

Q: 插件开发需要依赖第三方SDK,或需要依赖资源文件

如果您的插件需要依赖第三方的SDK,开发阶段引入三方SDK的时候要引入到主工程,然后将三方SDK提供的 .h 头文件直接添加到插件工程中这样就可以正常调用三方SDK的Api了,功能开发完毕后在构建插件包的时候,需要将依赖的三方SDK库文件放到ios路径下,然后按照规范编辑 package.json;

如果需要依赖资源文件比如图片等,建议把资源文件放到.bundle包中使用,开发阶段资源文件也要添加到主工程中,不然引用不到,功能开发完毕后在构建插件包的时候,把 bundle 包放到 ios 路径下,然后按照规范配置 package.json,注意:xib 文件也属于资源文件,需要放到主工程中;


现在遇到问题是,在我Xcode下按要求在主工程导入第三方SDK的库,也导入了他的.h文件在我的插件工程下,xcode可以调取到我需要的第三方SDK的api,及正常运行了,但是我配置好package后,在云打包自定义基座运行,可是却没法办执行第三方SDK内的运行过程,我的地上那方库是openssl.framework,能否反馈给你这边,因为他的方法在三方库内,无法找到原因
2020-11-07 11:29