From 3dabd84a72544ee55e8aeb069ece6a7c4a430091 Mon Sep 17 00:00:00 2001 From: Alexey Gulev Date: Sat, 28 Sep 2024 07:50:40 +0200 Subject: [PATCH] fix bob (#479) --- docs/en/manuals/bob.md | 34 ++++---- docs/ko/manuals/bob.md | 34 ++++---- docs/ru/manuals/bob.md | 36 ++++---- docs/zh/manuals/bob.md | 185 ++++++++++++++++++++++++++--------------- 4 files changed, 179 insertions(+), 110 deletions(-) diff --git a/docs/en/manuals/bob.md b/docs/en/manuals/bob.md index f2cb0298..84e2ddde 100644 --- a/docs/en/manuals/bob.md +++ b/docs/en/manuals/bob.md @@ -38,16 +38,16 @@ usage: bob [options] [commands] binary will be placed. Default is "//" -bo,--bundle-output Bundle output directory - -br,--build-report DEPRECATED in Defold 1.4.6! Use + -br,--build-report DEPRECATED! Use --build-report-json instead -brhtml,--build-report-html Filepath where to save a build report as HTML -brjson,--build-report-json Filepath where to save a build - report as JSON (from Defold 1.4.6) + report as JSON --build-artifacts If left out, will default to build the engine. Choices: - 'engine', 'plugins'. Comma - separated list. + 'engine', 'plugins', 'library'. + Comma separated list. --build-server The build server (when using native extensions) --build-server-header Additional build server header to @@ -58,6 +58,8 @@ usage: bob [options] [commands] instead --debug-ne-upload Outputs the files sent to build server as upload.zip + --debug-output-spirv Force build SPIR-V shaders + --debug-output-wgsl Force build WGSL shaders --defoldsdk What version of the defold sdk (sha1) to use -e,--email User email @@ -66,11 +68,10 @@ usage: bob [options] [commands] create an empty Defold application for use as a build target - --exclude-build-folder DEPRECATED from Defold 1.5.1! Use - '.defignore' file instead + --exclude-build-folder DEPRECATED! Use '.defignore' file + instead -h,--help This help message - -i,--input Source directory. Default is - current directory + -i,--input DEPRECATED! Use --root instead --identity Sign identity (iOS) -kp,--key-pass Password of the deployment key if different from the keystore @@ -88,8 +89,13 @@ usage: bob [options] [commands] --manifest-public-key Public key to use when signing manifest and archive. --max-cpu-threads Max count of threads that bob.jar - can use (from Defold 1.4.6) + can use -mp,--mobileprovisioning mobileprovisioning profile (iOS) + --ne-build-dir Specify a folder with includes or + source, to build a specific + library. More than one occurrance + is allowed. + --ne-output-name Specify a library target name -o,--output Output directory. Default is "build/default" -p,--platform Platform (when building and @@ -106,9 +112,9 @@ usage: bob [options] [commands] --resource-cache-remote-user Username to authenticate access to the remote resource cache. --settings Path to a game project settings - file. More than one occurrance - are allowed. The settings files - are applied left to right. + file. More than one occurrance is + allowed. The settings files are + applied left to right. --strip-executable Strip the dmengine of debug symbols (when bundling iOS or Android) @@ -117,8 +123,8 @@ usage: bob [options] [commands] -tp,--texture-profiles DEPRECATED! Use --texture-compression instead -u,--auth User auth token - --use-async-build-server DEPRECATED! Asynchronous build - is now the default. + --use-async-build-server DEPRECATED! Asynchronous build is + now the default. --use-lua-bytecode-delta Use byte code delta compression when building for multiple architectures diff --git a/docs/ko/manuals/bob.md b/docs/ko/manuals/bob.md index 59b24034..05b12fb3 100644 --- a/docs/ko/manuals/bob.md +++ b/docs/ko/manuals/bob.md @@ -30,16 +30,16 @@ usage: bob [options] [commands] binary will be placed. Default is "//" -bo,--bundle-output Bundle output directory - -br,--build-report DEPRECATED in Defold 1.4.6! Use + -br,--build-report DEPRECATED! Use --build-report-json instead -brhtml,--build-report-html Filepath where to save a build report as HTML -brjson,--build-report-json Filepath where to save a build - report as JSON (from Defold 1.4.6) + report as JSON --build-artifacts If left out, will default to build the engine. Choices: - 'engine', 'plugins'. Comma - separated list. + 'engine', 'plugins', 'library'. + Comma separated list. --build-server The build server (when using native extensions) --build-server-header Additional build server header to @@ -50,6 +50,8 @@ usage: bob [options] [commands] instead --debug-ne-upload Outputs the files sent to build server as upload.zip + --debug-output-spirv Force build SPIR-V shaders + --debug-output-wgsl Force build WGSL shaders --defoldsdk What version of the defold sdk (sha1) to use -e,--email User email @@ -58,11 +60,10 @@ usage: bob [options] [commands] create an empty Defold application for use as a build target - --exclude-build-folder DEPRECATED from Defold 1.5.1! Use - '.defignore' file instead + --exclude-build-folder DEPRECATED! Use '.defignore' file + instead -h,--help This help message - -i,--input Source directory. Default is - current directory + -i,--input DEPRECATED! Use --root instead --identity Sign identity (iOS) -kp,--key-pass Password of the deployment key if different from the keystore @@ -80,8 +81,13 @@ usage: bob [options] [commands] --manifest-public-key Public key to use when signing manifest and archive. --max-cpu-threads Max count of threads that bob.jar - can use (from Defold 1.4.6) + can use -mp,--mobileprovisioning mobileprovisioning profile (iOS) + --ne-build-dir Specify a folder with includes or + source, to build a specific + library. More than one occurrance + is allowed. + --ne-output-name Specify a library target name -o,--output Output directory. Default is "build/default" -p,--platform Platform (when building and @@ -98,9 +104,9 @@ usage: bob [options] [commands] --resource-cache-remote-user Username to authenticate access to the remote resource cache. --settings Path to a game project settings - file. More than one occurrance - are allowed. The settings files - are applied left to right. + file. More than one occurrance is + allowed. The settings files are + applied left to right. --strip-executable Strip the dmengine of debug symbols (when bundling iOS or Android) @@ -109,8 +115,8 @@ usage: bob [options] [commands] -tp,--texture-profiles DEPRECATED! Use --texture-compression instead -u,--auth User auth token - --use-async-build-server DEPRECATED! Asynchronous build - is now the default. + --use-async-build-server DEPRECATED! Asynchronous build is + now the default. --use-lua-bytecode-delta Use byte code delta compression when building for multiple architectures diff --git a/docs/ru/manuals/bob.md b/docs/ru/manuals/bob.md index 9a055c61..0dff2549 100644 --- a/docs/ru/manuals/bob.md +++ b/docs/ru/manuals/bob.md @@ -32,16 +32,16 @@ usage: bob [options] [commands] binary will be placed. Default is "//" -bo,--bundle-output Bundle output directory - -br,--build-report DEPRECATED in Defold 1.4.6! Use - --build-report-json instead + -br,--build-report DEPRECATED! Use + --build-report-json instead -brhtml,--build-report-html Filepath where to save a build report as HTML -brjson,--build-report-json Filepath where to save a build - report as JSON (from Defold 1.4.6) + report as JSON --build-artifacts If left out, will default to build the engine. Choices: - 'engine', 'plugins'. Comma - separated list. + 'engine', 'plugins', 'library'. + Comma separated list. --build-server The build server (when using native extensions) --build-server-header Additional build server header to @@ -52,6 +52,8 @@ usage: bob [options] [commands] instead --debug-ne-upload Outputs the files sent to build server as upload.zip + --debug-output-spirv Force build SPIR-V shaders + --debug-output-wgsl Force build WGSL shaders --defoldsdk What version of the defold sdk (sha1) to use -e,--email User email @@ -60,11 +62,10 @@ usage: bob [options] [commands] create an empty Defold application for use as a build target - --exclude-build-folder Comma separated list of folders - to exclude from the build + --exclude-build-folder DEPRECATED! Use '.defignore' file + instead -h,--help This help message - -i,--input Source directory. Default is - current directory + -i,--input DEPRECATED! Use --root instead --identity Sign identity (iOS) -kp,--key-pass Password of the deployment key if different from the keystore @@ -82,8 +83,13 @@ usage: bob [options] [commands] --manifest-public-key Public key to use when signing manifest and archive. --max-cpu-threads Max count of threads that bob.jar - can use (from Defold 1.4.6) + can use -mp,--mobileprovisioning mobileprovisioning profile (iOS) + --ne-build-dir Specify a folder with includes or + source, to build a specific + library. More than one occurrance + is allowed. + --ne-output-name Specify a library target name -o,--output Output directory. Default is "build/default" -p,--platform Platform (when building and @@ -100,9 +106,9 @@ usage: bob [options] [commands] --resource-cache-remote-user Username to authenticate access to the remote resource cache. --settings Path to a game project settings - file. More than one occurrance - are allowed. The settings files - are applied left to right. + file. More than one occurrance is + allowed. The settings files are + applied left to right. --strip-executable Strip the dmengine of debug symbols (when bundling iOS or Android) @@ -111,8 +117,8 @@ usage: bob [options] [commands] -tp,--texture-profiles DEPRECATED! Use --texture-compression instead -u,--auth User auth token - --use-async-build-server DEPRECATED! Asynchronous build - is now the default. + --use-async-build-server DEPRECATED! Asynchronous build is + now the default. --use-lua-bytecode-delta Use byte code delta compression when building for multiple architectures diff --git a/docs/zh/manuals/bob.md b/docs/zh/manuals/bob.md index 1b8211b3..9b61109a 100644 --- a/docs/zh/manuals/bob.md +++ b/docs/zh/manuals/bob.md @@ -24,73 +24,124 @@ Bob 运行于命令行界面 `java` (再Windows上是 `java.exe`) 后跟bob的ja ```text $ java -jar bob.jar --help usage: bob [options] [commands] --a,--archive 编译数据包 --ar,--architectures 逗号分割的发布平台包含的架构列表 - --archive-resource-padding 游戏包中的资源对齐间隔. 默认值为4. --bf,--bundle-format 逗号分割的发布平台格式列表 - (Android: 'apk' 和 'aab') - --binary-output 指定可执行文件存放地址, 默认地址是 - "//" --bo,--bundle-output 打包输出目录 --br,--build-report 自从 Defold 1.4.6 版本后已弃用! - 使用 --build-report-json 代替 --brhtml,--build-report-html 指定编译生成的HTML报告的存放地址 --brjson,--build-report-json 保存 JSON 编译报告的文件路径位置 (自从 Defold 1.4.6 版本启用) - --build-artifacts 不指定的话默认为编译engine. - 可选项为 'engine', 'plugins'. - 以逗号分隔. - --build-server 编译服务器 (使用原生扩展时需指定) - --build-server-header 设置 build server header --ce,--certificate 已弃用! 使用 --keystore 代替 --d,--debug 已弃用! 使用 --variant=debug 代替 - --debug-ne-upload 把文件打包為upload.zip后上傳到 - 編譯服務器 - --defoldsdk 指定 defold sdk (sha1) 使用版本 --e,--email 用户电邮 --ea,--exclude-archive 要从打包中排除的资源档案. 以此创建空应用用作编译目标 - --exclude-build-folder 自从 Defold 1.5.1 已弃用! 使用 - '.defignore' 文件代替 --h,--help 该命令的帮助文档 --i,--input 指定源目录, 默认是当前目录 - --identity 指定签名 (iOS) --kp,--key-pass 如果开发密钥不同于部署密钥的话 - 则在这里指定 (Android) --ks,--keystore 用来签名 APKs (Android) 的部署密钥 --ksa,--keystore-alias 用来签名 (Android) 的 key+cert 别名 --ksp,--keystore-pass 用来签名 (Android) 的部署密钥密码 --l,--liveupdate 要在发布后使用热更新功能, 该参数填 yes - - --manifest-private-key 用来签名 manifest 和 archive 的私钥 - - --manifest-public-key 用来签名 manifest 和 archive 的公钥 - --max-cpu-threads 设置 bob.jar 使用的最多线程数 - (自从 Defold 1.4.6 版本启用) --mp,--mobileprovisioning 指定 mobileprovisioning profile (iOS) --o,--output 输出目录. 默认是 "build/default" --p,--platform 发布平台 (打包时) --pk,--private-key 已弃用! 使用 --keystore 代替 --r,--root 指定编译根目录. 默认是当前目录 - --resource-cache-local 本地资源缓存地址. - --resource-cache-remote 远程资源缓存URL. - --resource-cache-remote-pass 远程资源存取认证的密码/令牌. - --resource-cache-remote-user 远程资源存取认证的用户名. - --settings 指定项目配置文件的路径. 可以使用多个 - 文件. 配置文件从左到右依次被应用. - --strip-executable 去掉dmengine的debug信息 (编译 iOS 或 Android时) --tc,--texture-compression 使用纹理档案中指定的纹理压缩 --tp,--texture-profiles 已弃用! 使用 --texture-compression 代替 --u,--auth 用户认证令牌 - --use-async-build-server DEPRECATED! Asynchronous build - is now the default. - --use-lua-bytecode-delta 为多平台编译时使用字节码 delta 压缩 - --use-uncompressed-lua-source 使用未压缩未加密的明文Lua源代码代替二进制文件 - --use-vanilla-lua 已弃用! 使用 --use-uncompressed-lua-source 代替 - --v,--verbose 冗余输出 - --variant 指定使用 debug, release 或者 headless - 的dmengine版本 (编译时) - --version 打印输出版本号 - --with-symbols 生成标记文件 (如果可用) + -a,--archive Build archive + -ar,--architectures Comma separated list of + architectures to include for the + platform + --archive-resource-padding The alignment of the resources in + the game archive. Default is 4 + -bf,--bundle-format Which formats to create the + application bundle in. Comma + separated list. (Android: 'apk' + and 'aab') + --binary-output Location where built engine + binary will be placed. Default is + "//" + -bo,--bundle-output Bundle output directory + -br,--build-report DEPRECATED! Use + --build-report-json instead + -brhtml,--build-report-html Filepath where to save a build + report as HTML + -brjson,--build-report-json Filepath where to save a build + report as JSON + --build-artifacts If left out, will default to + build the engine. Choices: + 'engine', 'plugins', 'library'. + Comma separated list. + --build-server The build server (when using + native extensions) + --build-server-header Additional build server header to + set + -ce,--certificate DEPRECATED! Use --keystore + instead + -d,--debug DEPRECATED! Use --variant=debug + instead + --debug-ne-upload Outputs the files sent to build + server as upload.zip + --debug-output-spirv Force build SPIR-V shaders + --debug-output-wgsl Force build WGSL shaders + --defoldsdk What version of the defold sdk + (sha1) to use + -e,--email User email + -ea,--exclude-archive Exclude resource archives from + application bundle. Use this to + create an empty Defold + application for use as a build + target + --exclude-build-folder DEPRECATED! Use '.defignore' file + instead + -h,--help This help message + -i,--input DEPRECATED! Use --root instead + --identity Sign identity (iOS) + -kp,--key-pass Password of the deployment key if + different from the keystore + password (Android) + -ks,--keystore Deployment keystore used to sign + APKs (Android) + -ksa,--keystore-alias The alias of the signing key+cert + you want to use (Android) + -ksp,--keystore-pass Password of the deployment + keystore (Android) + -l,--liveupdate Yes if liveupdate content should + be published + --manifest-private-key Private key to use when signing + manifest and archive. + --manifest-public-key Public key to use when signing + manifest and archive. + --max-cpu-threads Max count of threads that bob.jar + can use + -mp,--mobileprovisioning mobileprovisioning profile (iOS) + --ne-build-dir Specify a folder with includes or + source, to build a specific + library. More than one occurrance + is allowed. + --ne-output-name Specify a library target name + -o,--output Output directory. Default is + "build/default" + -p,--platform Platform (when building and + bundling) + -pk,--private-key DEPRECATED! Use --keystore + instead + -r,--root Build root directory. Default is + current directory + --resource-cache-local Path to local resource cache. + --resource-cache-remote URL to remote resource cache. + --resource-cache-remote-pass Password/token to authenticate + access to the remote resource + cache. + --resource-cache-remote-user Username to authenticate access + to the remote resource cache. + --settings Path to a game project settings + file. More than one occurrance is + allowed. The settings files are + applied left to right. + --strip-executable Strip the dmengine of debug + symbols (when bundling iOS or + Android) + -tc,--texture-compression Use texture compression as + specified in texture profiles + -tp,--texture-profiles DEPRECATED! Use + --texture-compression instead + -u,--auth User auth token + --use-async-build-server DEPRECATED! Asynchronous build is + now the default. + --use-lua-bytecode-delta Use byte code delta compression + when building for multiple + architectures + --use-uncompressed-lua-source Use uncompressed and unencrypted + Lua source code instead of byte + code + --use-vanilla-lua DEPRECATED! Use + --use-uncompressed-lua-source + instead. + -v,--verbose Verbose output + --variant Specify debug, release or + headless version of dmengine + (when bundling) + --version Prints the version number to the + output + --with-symbols Generate the symbol file (if + applicable) ``` 支持的命令: