【uniapp】iOS—原生配置教程

官方离线打包文档
iOS 原生工程配置

======== 问题汇总 ========

问题1：运行提示appkey未配置或配置错误

这就是没有配置 dcloud_appkey 或者配置错了，appkey是从DCloud 后台获取的一个加密串，不要配置成 appid（__UNI__XXXXX）

问题2：运行后程序白屏，不报错

原因一：Pandora->apps 下的 uniapp 文件出错。该文件以 appid 命名，里面有 www 文件夹，该文件是从 HBuilderX 中导出来的，不是直接把 HBuilderX 的文件直接拷贝进来。

========================

1. 下载官方SDK

下载地址：https://nativesupport.dcloud.net.cn/AppDocs/download/ios

下载完解压缩目录

[SDK目录说明]

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

目录别动其他的文件，我们只需要打开【HBuilder-Hello】工程

2. 申请 Appkey

由于笔者开始玩 uniapp 已经成熟，所以需要配置 appkey

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

2.1 创建应用

点击应用名可进入应用详情页

创建应用

2.2 配置 BundleId

没有安卓可选择不勾选，只配置iOS bundleid，bundleid 需要配置在xcode工程里

配置 BundleId

生成 appKey，保存后面配置在xcode工程里

image.png

3. 导出 HBuilderX 生成本地打包资源

3.1 生成本地打包资源

image.png

3.2 找到路径

在 HBuilderX 控制台会显示导出路径，拿到导出类文件，需要放在xcode工程中

文件目录

导出文件示例

4. 用配置【HBuilder-Hello】工程

HBuilder-Hello

4.1 导入本地打包资源

把第三步导出的文件放置在 Pandora->apps 文件下

image.png

4.2 配置 BundleId

bundleid 是在【2.2】在应用里配置的bundleid，

image.png

Version 和 Build 号 也需要和 一致HBuilderX内配置一致

image.png

4.3 配置 appKey

搜索info.plist 文件，一般是HBuilder-Hello-Info.plist
appkey是【2.2】在DCloud后台生成的appkey，千万不要配置成appid __UNI_XXXX

appkey

4.4 配置 control.xml

把 control.xml appid 和 appver 按 HBuilderX 配置

image.png

4.5 配置 iOS 证书

不过多赘述了，根据buildleid配置好 iOS 类证书

然后 build xcode工程，在测试机上会展示 HBuilderX 的样式