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文件位置


相关推荐
传奇开心果编程35 分钟前
【SwiftUI入门练中学】第17课 通知与后台任务
学习·ui·ios·swiftui·swift
ii_best12 小时前
按键精灵手机端开发安卓版实战:手写一个可最小化、可拖动的「运行日志悬浮窗」(附完整 源码 + 踩坑记录)
android·ios·智能手机·自动化·ai编程·按键精灵
美狐美颜SDK开放平台14 小时前
Android与iOS直播APP美颜有什么区别?视频美颜SDK开发详解
android·ios·音视频·视频美颜sdk
程序鉴定师1 天前
2026年深圳小程序/App开发公司技术选型指南:从架构设计到交付标准全维度评估
java·小程序·uni-app·php·objective-c
Q26433650231 天前
【有源码】基于uni-app的旅游行程规划小程序-基于微信小程序的智慧文旅综合服务平台
java·微信小程序·小程序·uni-app·毕业设计·springboot·源代码
qq_316837752 天前
阿里云百炼 fun-asr-realtime uniapp vue3 调用
javascript·vue.js·uni-app
传奇开心果编程2 天前
【SwiftUI入门练中学】第7课 动画与手势:让界面更灵动
学习·macos·ui·ios·swiftui·swift
知潮网2 天前
发售刚十天,9999 元的 iPhone 18 Pro 解锁就重启
ios·iphone
特创数字科技2 天前
uniapp 图片全能处理|全平台支持(鸿蒙、安卓、苹果、web),实现九宫格、水印、滤镜、压缩、拼图
uni-app
2501_916007472 天前
苹果应用商店App Store上架费用标准及原因解析
android·ios·小程序·https·uni-app·iphone·webview