开发环境 | uni小程序SDK

开发环境

SDK目录说明

配置工程

uni-app项目

配置Appkey

配置应用标识(Bundle Identifier)

展示全部

# 开发环境

安装 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内不同文件的作用

# 配置工程

  找到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”结尾的项。

# 如何配置多渠道

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

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

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

# 如何配置暗黑模式

在需要的打包的原生工程中找到工程的配置文件-Info.plist，移除UIUserInterfaceStyle节点(若不想支持暗夜模式，添加该节点并将该节点的值修改为Light或Dark即可，其中Light为始终显示默认高亮模式，Dark为始终显示暗夜模式，值为String类型)
如需设置启动时的默认模式，在上述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.a 和 AppTrackingTransparency.framework（系统库） 添加到工程中，注意 AppTrackingTransparency.framework 的 Status 选择 Optional ，如下图所示