上传移动应用（iPhone、Android）到 Zealot 自建 App 分发系统。.zip

# fastlane-plugin-zealot [](https://rubygems.org/gems/fastlane-plugin-zealot) 上传移动应用（iPhone、Android）到 [Zealot](https://github.com/tryzealot/zealot) 自建 App 分发系统。 > Zealot 是一个开源自部署移动应用分发平台，提供 iOS、Android SDK、fastlane 等丰富组件库，打包分发流程、上传应用竟然如此简单、解决开发人员频繁打包的烦恼 🖖 ## 快速上手 这是一个 [_fastlane_](https://github.com/fastlane/fastlane) 插件。如果要使用 `fastlane-plugin-zealot` 可通过下面方法添加到 fastlane 体系中： ```bash $ fastlane add_plugin zealot ``` ## 功能列表 插件包含多个 actions 提供大家使用： ### zealot 上传 iOS (app/ipa)、Android (apk/abb) App 至 Zealot 系统，插件会通过参数和 CI 系统自动获取很多辅助信息。包括但不仅限于： - 使用 gym 或 gradle 打包生成的 app 文件路径 - 解析应用获取的应用名称、打包类型 - Git 提交日志 - Git 分支名 - Git 最后一次提交的 Commit Hash - CI 系统的名称 - CI 系统本次构建的 URL #### 参数和返回值 ``` +-----------------+-----------------------------------+------------------------+----------+ | zealot Options | +-----------------+-----------------------------------+------------------------+----------+ | Key | Description | Env Var | Default | +-----------------+-----------------------------------+------------------------+----------+ | endpoint | The endpoint of zealot | ZEALOT_ENDPOINT | | | token | The token of user | ZEALOT_TOKEN | | | channel_key | The key of app's channel | ZEALOT_CHANNEL_KEY | | | file | The path of app file. Optional | ZEALOT_FILE | | | | if you use the `gym`, `ipa`, | | | | | `xcodebuild` or `gradle` action. | | | | name | The name of app to display on | ZEALOT_NAME | | | | zealot | | | | changelog | The changelog of app | ZEALOT_CHANGELOG | | | slug | The slug of app | ZEALOT_SLUG | | | release_type | The release type of app | ZEALOT_RELEASE_TYPE | | | branch | The name of git branch | ZEALOT_BRANCH | | | git_commit | The hash of git commit | ZEALOT_GIT_COMMIT | | | custom_fields | The key-value hash of custom | ZEALOT_CUSTOM_FIELDS | | | | fields | | | | password | The password of app to download | ZEALOT_PASSWORD | | | source | The name of upload source | ZEALOT_SOURCE | fastlane | | ci_url | The name of upload source | ZEALOT_CI_CURL | | | timeout | Request timeout in seconds | ZEALOT_TIMEOUT | | | hide_user_token | replase user token to *** to | ZEALOT_HIDE_USER_TOKEN | true | | | keep secret | | | | verify_ssl | Should verify SSL of zealot | ZEALOT_VERIFY_SSL | true | | | service | | | | fail_on_error | Should an error uploading app | ZEALOT_FAIL_ON_ERROR | false | | | cause a failure | | | +-----------------+-----------------------------------+------------------------+----------+ * = default value is dependent on the user's system +-----------------------+---------------------------------------------+ | zealot Output Variables | +-----------------------+---------------------------------------------+ | Key | Description | +-----------------------+---------------------------------------------+ | ZEALOT_APP_ID | The id of app | | ZEALOT_RELEASE_ID | The id of app's release | | ZEALOT_RELEASE_URL | The release URL of the newly uploaded build | | ZEALOT_INSTALL_URL | The install URL of the newly uploaded build | | ZEALOT_QRCODE_URL | The QRCode URL of the newly uploaded build | | ZEAALOT_ERROR_MESSAGE | The error message during upload process | +-----------------------+---------------------------------------------+ ``` #### 样例 ```ruby # 自动根据上面结果来获取信息上传 lane :automatic_upload do # iOS gym # Android gradle # 根据 CI 系统自动获取提交日志 ci_changelog zealot( endpoint: 'http://localhost:3000', token: '...', channel_key: '...' ) # 或者通过环境变量配置参数 ENV['ZEALOT_ENDPOINT'] = 'http://localhost:3000' ENV['ZEALOT_TOKEN'] = '...' ENV['ZEALOT_CHANNEL_KEY'] = '...' # 这里就无需再配置参数 zealot end # 上传指定文件 lane :upload_file do zealot( endpoint: 'http://localhost:3000', token: '...', channel_key: '...', file: '.ipa_or_apk', custom_fields: { api_env: '测试环境' } ) end ``` ### zealot_debug_file 上传 iOS 的 dSYM 或 Android 的 Proguard 调试文件到 Zealot #### 参数和返回值 ``` +--------------------+-----------------------------------+---------------------------+---------+ | zealot_debug_file Options | +--------------------+-----------------------------------+---------------------------+---------+ | Key | Description | Env Var | Default | +--------------------+-----------------------------------+---------------------------+---------+ | endpoint | The endpoint of zealot | ZEALOT_ENDPOINT | | | token | The token of user | ZEALOT_TOKEN | | | channel_key | Any channel key of app | ZEALOT_CHANNEL_KEY | | | zip_file | Using given the path of zip file | DF_DSYM_ZIP_FILE | | | | to direct upload | | | | platform | The name of platfrom, avaiable | ZEALOT_PLATFORM | | | | value are | | | | | ios,mac,macos,osx,android | | | | path | The path of debug file | ZEALOT_PATH | | | | (iOS/macOS is archive path for | | | | | Xcode, Android is path for app | | | | | project) | | | | xcode_scheme | The scheme name of app | ZEALOT_XCODE_SCHEME | | | android_build_type | The build type of app | ZEALOT_ANDROID_BUILD_TYPE | release | | android_flavor | The product flavor of app | ZEALOT_ANDROID_FLAVOR | | | extra_files | A set file names | ZEALOT_EXTRA_FILES | [] | | output_path | The output path of compressed | DF_DSYM_OUTPUT_PATH | .