# 1 前置条件

# 1.1 准备

环境准备

Mac 电脑：
- Mac OS 10.14 以上，并保证网络通畅
- node.js v14 以上
- iOS
  - Xcode 14.1 以上
- Android
  - Java 1.8.0 以上
Windows 电脑
- node.js v14 以上
- Java 1.8.0 以上

# 1.2 打包时序图

# 2 打包流程

# 2.1 配置打包环境

命令行打包依赖于node环境，打包配置需要使用中台或者有界面打包工具导出，下面我们会详细介绍所需环境的介绍

安卓打包需要安装JDK JDK安装教程（已安装JDK的用户可以跳过这一步）

# 2.2 安装node环境

如果已经安装node环境，可跳过，直接进行下一步

# 2.3 安装ultra-pack命令

我们使用 npm 安装 ultra-pack 命令，需要回到跟目录


// 使用 cd 回到根目录
$ cd

$ npm install @ultragame/pack-cli --registry https://source.sdksrv.com/verdaccio/ -g

// 执行后出现下面内容，则安装完成

/usr/local/bin/ultra-pack -> /usr/local/lib/node_modules/@ultragame/pack-cli/src/index.js
+ @ultragame/pack-cli@2.7.3
added 75 packages from 85 contributors and updated 3 packages in 43.222s

// 使用ultra-pack -V
$ ultra-pack -V
2.7.3

// 使用ultra-pack -h查看帮助文档

Options:
  -V, --version                                        output the version number
  -p, --project <projectPath>                          项目文件路径
  -out, --output <outputPath>                          输出文件路径
  -config, --configFile <configFile>                   配置文件
  -scheme, --schemeName <schemeName>                   ios -> 工程target
  -outType, --outType <environment>                    ios -> 输出文件格式 (default: "dis")
  -dis, --dis <disCodeSignIdentity>                    ios -> dis证书
  -disSign, --disSign <disProvisioningProfilesPath>    ios -> dis签名
  -adhoc, --dis <disCodeSignIdentity>                  ios -> adhoc证书
  -adhocSign, --disSign <disProvisioningProfilesPath>  ios -> adhoc签名
  -dev, --dev <devCodeSignIdentity>                    ios -> dev证书
  -devSign, --devSign <devProvisioningProfilesPath>    ios -> dev签名
  -jar --jarPath <jarPath>                             android -> jar包路径
  -h, --help                                           display help for command

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

提示

我们建议直接使用-config一行命令出包，如果有其他参数想修改，只支持上述参数修改

如果涉及到config参数的变化。则必须使用有界面打包工具打一次包，然后导出最新的config，再使用最新的config命令行出包才能生效，如以下变化:

SDK渠道版本更新
中台渠道配置，客户端参数的修改（三方登录参数，logo和icon配置）

# 2.4 中台或者有界面打包工具导出打包配置

有2种方法可以导出打包配置，我们建议使用有界面打包工具导出配置文件，会更简单

提示

日志包含 打包成功 文字，则证明打包成功，失败会抛出错误

本文档对解决你的问题有所帮助？