uni-app 项目 iOS 个人免费真机调试打包全流程手册

环境:mac-m4的电脑

工具:HibuilderX ,Xcode

Xcode主要是生成描述文件和证书,HibuilderX主要是来打包的。

前言:

安卓包一小时搞定,苹果包搞了一天,查资料, 文。。像个宝宝一样,上下文关联差强人意,国产还得加油。最终在不断反复的问某歌问出来了。下面的文档也是问完它帮我整理的,就是不带截图,截图只好我自己来了。

第一步:在 HBuilderX 中确定应用标识 (Bundle ID)

  1. 打开 manifest.json,进入"源码视图"。
  2. 找到 "app-plus" -> "distribute" -> "ios" 节点,添加:
    "bundleidentifier" : "com.testuniapp"(确保此 ID 唯一且未被占用)。

避坑点: 如果此处为空,Xcode 联动的描述文件将无法匹配。务必保证 HBuilderX 和 Xcode 里的这一串字符完全一致。


第二步:在 Xcode 中配置签名环境

  1. 打开 Xcode,新建一个普通的 iOS App 项目。
  2. Signing & Capabilities 页面,勾选 Automatically manage signing
  3. Team 下拉框中点击 Add Account 登录你的 Apple ID,并选中它。
  4. Bundle Identifier 修改为第一步中设置的 com.test.uniapp

避坑点: 如果 Team 显示为 None 或飘红报错,描述文件将无法生成。必须等到红字消失,显示出"Xcode Managed Profile"字样为止。


第三步:触发生成并导出描述文件 (.mobileprovision)

  1. 使用数据线连接 iPhone,在 Xcode 顶部选择该手机作为运行目标。
  2. 点击左上角 "运行 (Run)" 按钮,直到手机上出现 App 图标。
  3. 运行完在你的手机上就能看出来多了个应用
  4. 回到 Signing & Capabilities 页面,点击 Provisioning Profile 行末尾带圈的 "i" 图标
  5. 在弹出的浮窗中,用鼠标按住顶部的齿轮图标,直接拖拽到桌面。

避坑点: 如果拖不出来,请按 Command + Shift + G 访问 ~/Library/MobileDevice/Provisioning Profiles 强制跳转寻找。


第四步:导出证书私钥 (.p12)

  1. 点击 Xcode 菜单栏 Settings -> Accounts -> 选中账号 -> Manage Certificates...
  2. 右键点击你的 Apple Development 证书,选择 Export...
  3. 保存为 .p12 格式,并设置一个 安装密码

这里的密码在 HBuilderX 打包时必须填写,请务必记牢。


第五步:在 HBuilderX 进行云打包

  1. 回到 HBuilderX
  2. 回到 HBuilderX,点击 发行 -> 原生App-云打包
  3. iOS应用标识 :填 com.test.uniapp
  4. 证书文件 :选择导出的 .p12
  5. 证书私钥密码:填第四步设置的密码。
  6. 证书profile文件:选择第三步拖出来的那个"齿轮"文件。

后面装到别的手机要用到爱斯助手,我没试,但可以直接装到你的手机上

第六步,app放到你的手机

连上数据线,可以直接运行到你的手机上


第七步:手机端信任与运行

  1. 安装生成的 .ipa 到手机。
  2. 手机打开:设置 -> 通用 -> VPN 与设备管理
  3. 点击你的 Apple ID,选择 "信任"

个人免费证书有效期仅 7 天,过期后需重新执行此流程续期。

ipa文件位置


相关推荐
星星电灯猴4 小时前
全面解决Charles抓取HTTPS请求响应中文乱码问题的方法与技巧
后端·ios
人月神话-Lee5 小时前
【WWDC】Core AI:iOS 端侧大模型新纪元
人工智能·ios·ai·swift·wwdc·core ai
2501_916007476 小时前
iOS 开发工具选择指南 从编辑器、编译器到自动化构建
ide·vscode·ios·objective-c·个人开发·swift·敏捷流程
库奇噜啦呼6 小时前
【iOS】源码学习-YYModel源码学习
学习·ios·cocoa
风华圆舞7 小时前
一个 Flutter 项目同时保留 Android、iOS、HarmonyOS 支持的实践
android·flutter·ios
2501_915921437 小时前
uni-app 上架 iOS 的完整流程(无需依赖 Mac)
android·macos·ios·小程序·uni-app·iphone·webview
Fatbobman(东坡肘子)7 小时前
WWDC 2026 初印象:符合预期,但更务实 -- 肘子的 Swift 周报 #139
人工智能·macos·ios·swiftui·swift·wwdc
for_ever_love__21 小时前
UI学习:UICollectionView瀑布流
学习·ui·ios·objective-c·cocoa
于先生吖1 天前
前后端分离二手商城开发,质检登记、回收回款整套业务源码部署教程
java·开发语言·uni-app