命令行当前最新版本: v3.2.0-u.0,与有界面v3.2.0版本同步

命令行版本适用于需要使用 CI(持续集成)的游戏,使用中台或者有界面版本导出的固定配置,一行命令快速出包

# 更新命令行版本打包工具

如何更新命令行版本,更新与安装命令一样,示例如下:


// 使用 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@3.2.0
added 75 packages from 85 contributors and updated 3 packages in 43.222s

// 使用ultra-pack -V
$ ultra-pack -V
3.2.0-u.0

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 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 打包时序图

uml diagram

# 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@3.2.0
added 75 packages from 85 contributors and updated 3 packages in 43.222s

// 使用ultra-pack -V
$ ultra-pack -V
3.2.0-u.0

// 使用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种方法可以导出打包配置,我们建议使用有界面打包工具导出配置文件,会更简单

提示

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

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