跨平台应用开发进阶(十四) ：uni-app 实现IOS原生APP-本地打包集成极光推送(JG-JPUSH)详细教程

分类：Swift作者：No Silver Bullet

文章目录

一、前言

在前期博文《跨平台应用开发进阶(十一) ：uni-app 实现IOS原生APP-云打包集成极光推送(JG-JPUSH)详细教程》中讲解了uni-app在集成极光过程中如何实现IOS原生APP云打包。

此篇博文主要讲解uni-app在集成极光过程中如何实现IOS原生APP本地打包。

iOS离线打包分为三部分：

  1. 下载离线打包SDK资源;
  2. 配置离线打包工程（证书、文件、图标、app名字等）;
  3. 配置模块（例如Geolocation、push模块等）;

二、打包前准备工作

HBuilderX 版本：3.4.7.20220422
iOS离线SDK版本：3.4.7.20220422

注意⚠️：务必确保HBuilderX 版本与iOS离线SDK版本保持一致。

2.1 基本工程配置

  1. 点击下载uniapp ios离线sdk。

  2. 解压刚刚下载的离线sdk，可以看到下面这些文件：

    在这里插入图片描述


    用xcode打开HBuilder-Hello这个项目。

  3. 使用Hbuilderx生成本地打包APP资源。

    在这里插入图片描述


    在这里插入图片描述


    本地打包代码生成好后，把生成的"__UNI__C1B4407"这个文件夹拷贝到Xcode项目目录下的 Pandora -> apps 路径下，替换掉原来的目录。

    在这里插入图片描述

  4. 打开 Xcode 工程Supporting Files目录下的control.xml文件修改appid值，改成和manifest.json里面的appid一样。

    在这里插入图片描述

  5. 在dcloud开发者中心生成appkey。

    appkey生成方法点击查看。

    在这里插入图片描述

  6. 打开Hbuilder-Hello-Info.plist修改dcloud_appkey，改为上一步申请的appkey。

    在这里插入图片描述

  7. 点击左侧应用工程根目录，选中TARGETS下的HBuilder打开工程属性界面，在"Signing & CapaBilities"选项卡下，设置以下几点。

实现IOS原生APP本地打包，需要在Xcode中完成。作为苹果开发者，P12证书与描述文件必不可少，需要提前准备。

2.2 项目配置

本地打包前，需要以下项目配置项：

  • 配置应用标识(Bundle Identifier)
  • 配置应用名称
  • 配置应用版本名称
  • 配置应用版本号
  • 配置应用图标
  • 配置应用启动界面
  • 配置国际化

2.1 配置应用标识(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值一致。

2.2 配置应用名称

1、在打开的原生工程中，点击工程的targets和点开manifest文件，然后将manifest文件里的“name”字段的内容和原生工程里的Display Name 写成一样。

注意⚠️：manifest文件里的”name“ 对应的是HBuilderX打开的工程里的“基础配置”里的应用名称。如下图红色框所示：

在这里插入图片描述


在这里插入图片描述

2.3 配置应用版本名称

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

2.4 配置应用版本号

在打开的原生工程中，点击工程的targets和点开工程里的manifest文件，然后将manifest文件里的“version”字段里的“code”内容和原生工程里的Build写成一样。

注意⚠️：manifest文件里“version”字段“code” 对应的是HBuilderX打开的工程里的“基础配置”里的应用版本号。如下图红色框所示：

在这里插入图片描述


在这里插入图片描述

2.5 配置应用图标

点击project->target->General->App Icons and Launch Images->App Icons Source项右侧小箭头。

在这里插入图片描述


在新开页面根据提示将对应尺寸的应用图标拖入到虚线框中即可。

在这里插入图片描述

2.6 配置应用启动界面

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

    在这里插入图片描述

  2. 使用官方已经制作好的storyboard，官方提供了2个storyboard，一个是图标、名称在上方的；另外一个是图标、名称在下方的(这种的LaunchScreen.storyboard主要是适配用户配置广告后，使其启动时不会有视觉上的跳跃感，增加用户体验)。

注意⚠️：在使用Launch Screen File方式作为启动界面时，需要把一张或几张清晰的图标拷贝到工程的根文件夹下并引入到工程中，用来给启动界面加载图标。如果拷贝过去的图标不清晰，会导致启动界面上出现图标不清晰、模糊的现象。

在这里插入图片描述


在这里插入图片描述

  1. 制作LaunchScreen.storyboard(这个storyboard的名称是可以自定义的)，如果想自定义LaunchScreen.storyboard， 这需要你会原生知识，知道怎样创建Launch Screen File，知道怎样在storyboard中布局视图，设置约束等。

注意⚠️：

  • 这里的storyboard，不是普通的storyboard；
  • 配置了广告之后，如果自定义的LaunchScreen.storyboard约束没设置好，会有启动页到广告页跳跃的视觉效果。

2.7 配置国际化

2.7.1 内容相关的国际化

离线打包时如果弹出提示框且内容为：“HTML5+ Rumtime D”时，需要在打包的原生工程里配置国际化如何配置。

2.7.2 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下对应的语言文件里去。

    在这里插入图片描述


    在这里插入图片描述

三、打包

以上项目配置工作完成后，就可以开展本地打包了。

3.1 证书导入

导入iOS证书p12到钥匙串，双击p12文件，登录，导入证书。

  1. 编译设备选择Generic iOS Device或者Any iOS Device。

注意⚠️：选择其他模拟器是不能Archive的。

在这里插入图片描述


2. Xcode 工具条 Product 下点击 Archive。

在这里插入图片描述


在这里插入图片描述


3. 如果弹出下面框，输入本机密码，始终允许。

在这里插入图片描述

  1. 点击Export。

    在这里插入图片描述

  2. 本地联调选择点击Ad Hoc。

    在这里插入图片描述

  3. 点击Next。

    在这里插入图片描述

  4. 选择证书,点击Next。

    在这里插入图片描述

  5. 最后点击导出，选择指定位置即可。

    在这里插入图片描述

四、如何用离线打包工程制作自定义调试基座

自定义调试基座是使用开发者申请的第三方SDK配置生成的基座应用，用于HBuilder/HBuilderX开发应用时实时在真机/模拟器上查看运行效果。

  1. 在打包原生工程里找到 control.xml文件，在HBuilder节点里查看是否有这2个： debug="true" syncDebug="true" 配置(注意-打AppStore包的时候，这个配置需要去掉，否则会导致热更新失败！)，没有的话增加上，然后保存。

  2. 确保Xcode工程的Bundle identifier不为 io.dcloud.HBuidler。

  3. 在原生工程里找到info.plist文件并增加一项，如下图：

    在这里插入图片描述

  4. 确保原生工程里Pandora文件夹下的apps文件夹里只有一个文件夹（文件夹的名称和里面的manifest的id值相同）;

  5. 确保control.xml文件里的appid的值和apps目录下的第一个文件夹的名称一致;

  6. 确保HBuilderX里要调试的代码的appid和control.xml的appid值一致;

  7. 使用Xcode的Product下的archive 打包，然后生成ipa，并把ipa名称命名为：iOS_debug.ipa;

  8. 在js工程里主目录下新建一个名称为unpackage的文件夹（如果有不用新建），再在unpackage文件夹下新建一个名称为debug文件夹，并把生成的iOS_debug.ipa包放入debug文件夹下。

    在这里插入图片描述

  9. 在HBuilderX里，找到之前appid相同的js工程准备调试，点击“运行” --“运行到手机或模拟器“--“使用自定义基座运行（iOS）”，等待连接成功之后就可以了。

  10. 运行
    连接手机，编译运行，如果App成功跑起来了，说明原生工程配置完成。

注意⚠️：iOS仅支持真机运行自定义基座，不能使用xcode模拟器运行自定义基座！

五、遇到的问题及解决措施

5.1 IOS签名证书p12无法导入

在这里插入图片描述


未复现，待复现后再给出解决方案。

5.2 描述文件不包含当前设备

Xcode本地离线打包，选择描述文件后，报如下错误信息：

Provisioning profile "****" doesn't include the currently selected device "huaqiang的MacBook Air" (identifier 00008103-000964343AD2001E).

在这里插入图片描述


被此问题折腾了2天，后来细心阅读文档，认真操作后发现是选择目标编译设备是默认选择了Mac设备导致，正确的选项应该是Any iOS Device!

在这里插入图片描述

5.3 “HBuilder” requires a provisioning profile. Select a provisioning profile in the Signing & Capabilities editor.

出现以上问题是由于Signing(Release)部分需要导入描述文件。

5.4 ‘PDRCore.h’ file not fond

在这里插入图片描述


出现以上问题是由于HBuilderX版本与iOS离线打包SDK版本不一致造成的，一定要确保HBuilderX版本与iOS离线打包SDK版本保持一致。

5.5 请确保自定义基座的iOS证书已添加iOS设备的UDID

在这里插入图片描述


出现以上问题的原因是Devices中未添加联调设备UDID。

解决方案，使用开发者账号登陆app developer。增加设备的UDID到Devices中。

在这里插入图片描述


如何查看设备的udid?

Unique Device Identifier (识别码)，使用safari浏览器打开https://www.pgyer.com/tools/udid，下载描述文件，然后去设置里面点击已下载描述文件安装，就可以看到自己的udid。

增加之后下载新的Provisioning Profiles。

在xcode中导入新的Provisioning Profiles，ok，不报错了，可以放心的打包了。

介绍一下Provisioning Profiles文件：

Provisioning Profiles，该文件将appID，开发者证书，硬件Device绑定到一块儿，在开发者中心配置好后可以添加到Xcode上，也可以直接在Xcode上连接开发者中心生成，真机调试时需要在PP文件中添加真机的udid。

5.6 p12⽂件与mobileprovition⽂件的关系梳理

p12⽂件
做 ios 开发的时候，会⽣成证书。
开发证书让苹果相信了你是⼀个合法的开发者。

P12备份⽂件 = CER⽂件 + 私钥

mobileprovition⽂件
你调试的真机设备（iPhone，ipad）被认为是个合法的测试设备。这个许可证就是设备的信任凭证。

当APP安装到真机上的时候，APP⾥的许可证信息和iPhone⾥的许可证如果匹配的话，就可以装的上了，否则就没法装上的。

许可证也分⼏种类型：develop版，adhoc版，appstore版本。这⾥说⼀下adhoc，这个版本主要是⽤于内部测试的版本。⽐如APP上线
前，需要N轮的QA测试。这个就是给他们测试的。测试没问题了，再打appstore版本，测试⽆误后提交苹果商店。

我们的每⼀个证书都可以⽣成⼀个.p12⽂件，这个⽂件是⼀个加密的⽂件，只要知道其密码，就可以供给所有的mac设备使⽤，使设备不
需要在苹果开发者⽹站重新申请开发和发布证书，就能使⽤。

注意⚠️：⼀般.p12⽂件是给与别⼈使⽤的，本机必须已经有⼀个带秘钥的证书才可以⽣成.p12⽂件。⽣成.p12⽂件之后，将.p12⽂件和描述⽂件(.mobileprovision)发送给其他使⽤者，让其他成员依次点击.mobileprovision和.p12证书⽂件(需要输⼊密码,密码就是当时⽣成.p12
⽂件时设定的密码)。这样这台电脑就可以⽤来打包、真机调试等了。

六、拓展阅读

原文地址：https://shq5785.blog.csdn.net

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 dio@foxmail.com 举报，一经查实，本站将立刻删除。

相关推荐

效率成吨提升之代码生成器-蓝湖工具神器iOS,Android,Swift,Flutter
软件简介:蓝湖辅助工具,减少移动端开发中控件属性的复制和粘贴.待开发的功能:1.支持自动生成约束2.开发设置页面3.做一个浏览器插件,支持不需要下载整个工程,可即时操作当前蓝湖浏览页面4.支持Flutter语言模板生成5.支持更多平台,如Sketch等6.支持用户自定义语言模板
【Audio音频开发】音频基础知识及PCM技术详解
现实生活中，我们听到的声音都是时间连续的，我们称为这种信号叫模拟信号。模拟信号需要进行数字化以后才能在计算机中使用。目前我们在计算机上进行音频播放都需要依赖于音频文件。那么音频文件如何生成的呢？音频文件的生成过程是将声音信息采样、量化和编码产生的数字信号的过程，我们人耳所能听到的声音频率范围为（20Hz~20KHz），因此音频文件格式的最大带宽是20KHZ。根据奈奎斯特的理论，音频文件的采样率一般在40~50KHZ之间。奈奎斯特采样定律，又称香农采样定律。...............
见过仙女蹦迪吗？一起用python做个小仙女代码蹦迪视频
前言最近在B站上看到一个漂亮的仙女姐姐跳舞视频，循环看了亿遍又亿遍，久久不能离开！看着小仙紫姐姐的蹦迪视频，除了一键三连还能做什么？突发奇想，能不能把舞蹈视频转成代码舞呢？说干就干，今天就手把手教大家如何把跳舞视频转成代码舞，跟着仙女姐姐一起蹦起来~视频来源：【紫颜】见过仙女蹦迪吗 【千盏】一、核心功能设计总体来说，我们需要分为以下几步完成：从B站上把小姐姐的视频下载下来对视频进行截取GIF，把截取的GIF通过ASCII Animator进行ASCII字符转换把转换的字符gif根据每
【Android App】实战项目之仿抖音的短视频分享App附源码和演示视频 超详细必看
【Android App】实战项目之仿抖音的短视频分享App（附源码和演示视频 超详细必看）
自定义ava数据集及训练与测试 完整版 时空动作/行为 视频数据集制作 yolov5, deep sort, VIA MMAction, SlowFast
前言这一篇博客应该是我花时间最多的一次了，从2022年1月底至2022年4月底。我已经将这篇博客的内容写为论文，上传至arxiv：https://arxiv.org/pdf/2204.10160.pdf欢迎大家指出我论文中的问题，特别是语法与用词问题在github上，我也上传了完整的项目：https://github.com/Whiffe/Custom-ava-dataset_Custom-Spatio-Temporally-Action-Video-Dataset关于自定义ava数据集，也是后台
【视频+源码】登录鉴权的三种方式：token、jwt、session实战分享
因为我既对接过session、cookie，也对接过JWT，今年因为工作需要也对接了gtoken的2个版本，对这方面的理解还算深入。尤其是看到官方文档评论区又小伙伴表示看不懂，所以做了这期视频内容出来：视频在这里：本期内容对应B站的开源视频因为涉及的知识点比较多，视频内容比较长。如果你觉得看视频浪费时间，可以直接阅读源码：goframe v2版本集成gtokengoframe v1版本集成gtokengoframe v2版本集成jwtgoframe v2版本session登录官方调用示例文档jwt和sess
【Android App】实战项目之仿微信的私信和群聊App附源码和演示视频 超详细必看
【Android App】实战项目之仿微信的私信和群聊App（附源码和演示视频 超详细必看）
零基础用Android Studio实现简单的本地视频播放器
用Android Studio的VideoView组件实现简单的本地视频播放器。本文将讲解如何使用Android视频播放器VideoView组件来播放本地视频和网络视频，实现起来还是比较简单的。VideoView组件的作用与ImageView类似，只是ImageView用于显示图片，VideoView用于播放视频。...
采用MATLAB对正弦信号，语音信号进行生成、采样和恢复，利用MATLAB工具箱对混杂噪声的音频信号进行滤波
采用MATLAB对正弦信号，语音信号进行生成、采样和内插恢复，利用MATLAB工具箱对混杂噪声的音频信号进行滤波
Keras深度学习实战40——音频生成
随着移动互联网、云端存储等技术的快速发展，包含丰富信息的音频数据呈现几何级速率增长。这些海量数据在为人工分析带来困难的同时，也为音频认知、创新学习研究提供了数据基础。在本节中，我们通过构建生成模型来生成音频序列文件，从而进一步加深对序列数据处理问题的了解。
视频实时行为检测——基于yolov5+deepsort+slowfast算法
基于yolov5+deepsort+slowfast算法的视频实时行为检测。1. yolov5实现目标检测，确定目标坐标 2. deepsort实现目标跟踪，持续标注目标坐标 3. slowfast实现动作识别，并给出置信率 4. 用框持续框住目标，并将动作类别以及置信度显示在框上
数电实验 数字电子钟设计 基于quartus 实现计时校时闹钟秒表稍复杂音频 分享电路图设计以及工程文件
数字电子钟设计本文主要完成数字电子钟的以下功能1、计时功能（24小时）2、秒表功能（一个按键实现开始暂停，另一个按键实现清零功能）3、闹钟功能（设置闹钟以及到时响10秒）4、校时功能5、其他功能（清零、加速、星期、八位数码管显示等）前排提示：前面几篇文章介绍过的内容就不详细介绍了，可以看我专栏的前几篇文章。PS.工程文件放在最后面总体设计本次设计主要是在前一篇文章 数字电子钟基本功能的实现 的基础上改编而成的，主要结构不变，分频器将50MHz分为较低的频率备用；dig_select
腾讯会议使用OBS虚拟摄像头
1.进入官网下载OBS stdioOpen Broadcaster Software | OBS (obsproject.com)2.下载一个插件,拓展OBS的虚拟摄像头功能链接：OBS 虚拟摄像头插件.zip_免费高速下载|百度网盘-分享无限制 (baidu.com)提取码：6656--来自百度网盘超级会员V1的分享**注意**该插件必须下载但OBS的根目录(应该是自动匹配了的)3.打开OBS,选中虚拟摄像头选择启用在底部添加一段视频录制选择下面,进行录制.
文本生成视频Make-A-Video，根据一句话就能一键生成视频 Meta新AI模型
Meta公司在9月29日首次推出一款人工智能系统模型：Make-A-Video，可以从给定的文字提示生成短视频。基于**文本到图像生成技术的最新进展**，该技术旨在实现文本到视频的生成，可以仅用几个单词或几行文本生成异想天开、独一无二的视频，将无限的想象力带入生活
信号处理——MATLAB音频信号加噪、滤波
音频信号叠加噪声及滤波一、前言二、信号分析及加噪三、滤波去噪四、总结一、前言之前一直对硬件上的内容比较关注，但是可能是因为硬件方面的东西可能真的是比较杂，而且需要渗透的东西太多了，所以学习进展比较缓慢。因为也很少有单纯的硬件学习研究，总是会伴随着各种理论需要硬件做支撑，所以还是想要慢慢接触理论学习。但是之前总找不到切入点，不知道从哪里开始，就一直拖着。最近稍微接触了一点信号处理，就用这个当作切入点，开始接触理论学习。二、信号分析及加噪信号处理选用了matlab做工具，选了一个最简单的语音信号处理方
【新知实验室 - TRTC 实践】音视频互动 Demo、即时通信 IM 服务搭建
腾讯云 TRTC 实时音视频服务体验，从认识 TRTC 到 TRTC 的开发实践，Demo 演示& IM 服务搭建。
Keras深度学习实战39——音乐音频分类
音乐音频分类技术能够基于音乐内容为音乐添加类别标签,在音乐资源的高效组织、检索和推荐等相关方面的研究和应用具有重要意义。传统的音乐分类方法大量使用了人工设计的声学特征，特征的设计需要音乐领域的知识，不同分类任务的特征往往并不通用。深度学习的出现给更好地解决音乐分类问题提供了新的思路，本文对基于深度学习的音乐音频分类方法进行了研究。首先将音乐的音频信号转换成声谱作为统一表示，避免了手工选取特征存在的问题，然后基于一维卷积构建了一种音乐分类模型。
C++游戏game | 井字棋游戏坤坤版配资源+视频【赋源码，双人对战】
C++知识精讲16 | 井字棋游戏（配资源+视频）【赋源码，双人对战】
基于FFmpeg的Java视频Mp4转GIF初探
本文主要讲解如何在Java中，使用FFmpeg进行视频的帧读取，并最终合并成Gif动态图。
深入浅出 Swift 中的 some、any 关键字以及主关联类型primary associated types
在本篇博文中，我们谈及了 Swift 中 some、any 关键字以及主关联类型（primary associated types）的前世今生，并由浅及深用简明的示例向大家讲解了它们之间的奥秘玄机。
pythonJavaScriptjavaHTMLPHPreactjsC#AndroidCSSNode.jssqlrpython-3.xMysqLjQueryc++pandasFlutterangularIOSdjangolinuxswifttypescript路由器JSON路由器设置无线路由器h3c华三华三路由器设置华三路由器电脑软件教程arraysdocker软件图文教程Cvue.jslaravelspring-boot