lib/fir/cli.rb
# frozen_string_literal: true
module FIR
class CLI < Thor
class_option :token, type: :string, aliases: '-T', desc: "User's API Token at fir.im"
class_option :logfile, type: :string, aliases: '-L', desc: 'Path to writable logfile'
class_option :verbose, type: :boolean, aliases: '-V', desc: 'Show verbose', default: true
class_option :quiet, type: :boolean, aliases: '-q', desc: 'Silence commands'
class_option :help, type: :boolean, aliases: '-h', desc: 'Show this help message and quit'
desc '(EXPIRED, PLEASE use fastlane instead) build_ipa BUILD_DIR [options] [settings]', 'Build iOS app (alias: `bi`).'
long_desc <<-LONGDESC
`build_ipa` command will auto build your project/workspace to an ipa package
and it also can auto publish your built ipa to fir.im if use `-p` option.
Internally, it use `xcodebuild` to accomplish these things, use `man xcodebuild` to get more information.
Example:
$ fir bi <project dir> [-C <configuration>] [-t <target name>] [-o <ipa output dir>] [settings] [-c <changelog>] [-p -Q -T <your api token>]
$ fir bi <project dir> [-c <changelog> -P <bughd project id> -M -p -Q -T <your api token>]
$ fir bi <git ssh url> [-B develop -c <changelog> -f <profile> -P <bughd project id> -M -p -Q -T <your api token>]
$ fir bi <workspace dir> -w -S <scheme name> [-C <configuration>] [-t <target name>] [-o <ipa output dir>] [settings] [-c <changelog>] [-p -Q -T <your api token>]
LONGDESC
map %w[b bi] => :build_ipa
method_option :branch, type: :string, aliases: '-B', desc: 'Set branch if project is a git repo, the default is `master`'
method_option :workspace, type: :boolean, aliases: '-w', desc: 'true/false if build workspace'
method_option :scheme, type: :string, aliases: '-S', desc: 'Set the scheme NAME if build workspace'
method_option :configuration, type: :string, aliases: '-C', desc: 'Use the build configuration NAME for building each target'
method_option :destination, type: :string, aliases: '-d', desc: 'Set the destination specifier'
method_option :target, type: :string, aliases: '-t', desc: 'Build the target specified by target name'
method_option :export_method, type: :string, aliases: '-E', desc: 'for exportOptionsPlist method, ad-hoc as default'
method_option :optionPlistPath, type: :string, aliases: '-O', desc: 'User defined exportOptionsPlist path'
method_option :profile, type: :string, aliases: '-f', desc: 'Set the export provisioning profile'
method_option :output, type: :string, aliases: '-o', desc: 'IPA output path, the default is: BUILD_DIR/fir_build_ipa'
method_option :publish, type: :boolean, aliases: '-p', desc: 'true/false if publish to fir.im'
method_option :short, type: :string, aliases: '-s', desc: 'Set custom short link if publish to fir.im'
method_option :name, type: :string, aliases: '-n', desc: 'Set custom ipa name when built'
method_option :changelog, type: :string, aliases: '-c', desc: 'Set changelog if publish to fir.im'
method_option :qrcode, type: :boolean, aliases: '-Q', desc: 'Generate qrcode'
method_option :mapping, type: :boolean, aliases: '-M', desc: 'true/false if upload app mapping file to BugHD.com'
method_option :proj, type: :string, aliases: '-P', desc: 'Project id in BugHD.com if upload app mapping file'
method_option :open, type: :boolean, desc: 'true/false if open for everyone'
method_option :password, type: :string, desc: 'Set password for app'
def build_ipa(*args)
prepare :build_ipa
FIR.build_ipa(*args, options)
end
desc 'build_apk BUILD_DIR', 'Build Android app (alias: `ba`).'
long_desc <<-LONGDESC
`build_apk` command will auto build your project to an apk package
and it also can auto publish your built apk to fir.im if use `-p` option.
Internally, it use `gradle` to accomplish these things, use `gradle --help` to get more information.
Example:
$ fir ba <project dir> [-o <apk output dir> -c <changelog> -p -Q -T <your api token>]
$ fir ba <project dir> [-f <flavor> -o <apk output dir> -c <changelog> -p -Q -T <your api token>]
$ fir ba <git ssh url> [-B develop -o <apk output dir> -c <changelog> -p -Q -T <your api token>]
LONGDESC
map ['ba'] => :build_apk
method_option :branch, type: :string, aliases: '-B', desc: 'Set branch if project is a git repo, the default is `master`'
method_option :output, type: :string, aliases: '-o', desc: 'APK output path, the default is: BUILD_DIR/build/outputs/apk'
method_option :publish, type: :boolean, aliases: '-p', desc: 'true/false if publish to fir.im'
method_option :flavor, type: :string, aliases: '-f', desc: 'Set flavor if have productFlavors'
method_option :short, type: :string, aliases: '-s', desc: 'Set custom short link if publish to fir.im'
method_option :name, type: :string, aliases: '-n', desc: 'Set custom apk name when builded'
method_option :changelog, type: :string, aliases: '-c', desc: 'Set changelog if publish to fir.im, support string/file'
method_option :qrcode, type: :boolean, aliases: '-Q', desc: 'Generate qrcode'
method_option :open, type: :boolean, desc: 'true/false if open for everyone, the default is: true', default: true
method_option :password, type: :string, desc: 'Set password for app'
def build_apk(*args)
prepare :build_apk
FIR.build_apk(*args, options)
end
desc 'info APP_FILE_PATH', 'Show iOS/Android app info, support ipa/apk file (aliases: `i`).'
map 'i' => :info
method_option :all, type: :boolean, aliases: '-a', desc: 'Show all information in application'
def info(*args)
prepare :info
FIR.info(*args, options)
end
desc 'publish APP_FILE_PATH', 'Publish iOS/Android app to fir.im, support ipa/apk file (aliases: `p`).'
long_desc <<-LONGDESC
`publish` command will publish your app file to fir.im, also the command support to publish app's short & changelog.
Example:
$ fir p <app file path> [-c <changelog> -s <custom short link> -Q -T <your api token>]
$ fir p <app file path> [-c <changelog> -s <custom short link> --password=123456 --open=false -Q -T <your api token>]
$ fir p <app file path> [-c <changelog> -s <custom short link> -m <mapping file path> -P <bughd project id> -Q -T <your api token>]
LONGDESC
map 'p' => :publish
method_option :short, type: :string, aliases: '-s', desc: 'Set custom short link'
method_option :changelog, type: :string, aliases: '-c', desc: 'Set changelog'
method_option :qrcode, type: :boolean, aliases: '-Q', desc: 'Generate qrcode'
method_option :need_ansi_qrcode, type: :boolean, default: false, desc: 'Generate qrcode'
method_option :need_release_id, type: :boolean, aliases: '-R', default: false, desc: 'Add release id with fir url (WARNING: FIR ONLY SAVED 30 releases recently per app'
method_option :force_pin_history, type: :boolean, aliases: '-H', default: false, desc: 'pin this release to the download page by force'
method_option :skip_update_icon, type: :boolean, aliases: '-S', default: false, desc: 'skip update app icon'
method_option :specify_icon_file, type: :string, desc: 'specify icon file'
method_option :skip_fir_cli_feedback, type: :boolean, default: false, desc: 'skip fir-cli usage info feedback'
method_option :specify_app_display_name, type: :string, desc: 'specify app display name'
method_option :switch_to_qiniu, type: :boolean, default: false, aliases: '-N', desc: 'if app upload slowly, u can switch this option'
method_option :oversea_turbo, type: :boolean, default: false, desc: 'speed up uploading to oversea users'
method_option :mappingfile, type: :string, aliases: '-m', desc: 'App mapping file'
method_option :dingtalk_access_token, type: :string, aliases: '-D', desc: 'Send msg to dingtalk, only need access_token, not whole url'
method_option :dingtalk_custom_message, type: :string, desc: 'add custom message to dingtalk'
method_option :dingtalk_at_phones, type: :string, desc: 'at some phones, split by , eg: 13111111111,13111111112'
method_option :dingtalk_at_all, type: :boolean, default: false
method_option :dingtalk_secret, type: :string, desc: 'dingtalk bot secret code (eg: SEC********)'
method_option :feishu_access_token, type: :string, desc: 'Send msg to feishu, need access_token, not whole url'
method_option :feishu_custom_title, type: :string, desc: 'add custom title to feishu'
method_option :feishu_custom_message, type: :string, desc: 'add custom message to feishu'
method_option :wxwork_webhook, type: :string, desc: 'wxwork webhook url (optional)'
method_option :wxwork_access_token, type: :string, desc: 'Send msg to wxwork group, need group bot webhook, not whole url'
method_option :wxwork_custom_message, type: :string, desc: 'add custom message to wxwork group'
method_option :wxwork_pic_url, type: :string, desc: 'message background image, best size is 1068x455'
method_option :open, type: :boolean, desc: 'true/false if open for everyone'
method_option :password, type: :string, desc: 'Set password for app'
method_option :bundletool_jar_path, type: :string, desc: "upload aab file command: to specify bundletool.jar if command bundletool can not run directly"
method_option :auto_download_bundletool_jar, type: :boolean, default: false, desc: "upload aab file command: would download bundletool when invoke bundletool failure"
method_option :save_uploaded_info, type: :boolean, default: false, desc: 'save uploaded info to local file named fir-cli-answer.json'
def publish(*args)
prepare :publish
FIR.publish(*args, options)
end
desc 'login', 'Login fir.im (aliases: `l`).'
map 'l' => :login
def login(*args)
prepare :login
token = options[:token] || args.first || ask('Please enter your fir.im API Token:', :white, echo: true)
FIR.login(token)
end
desc 'me', 'Show current user info if user is logined.'
def me
prepare :me
FIR.me
end
desc 'upgrade', 'Upgrade fir-cli and quit (aliases: `u`).'
map 'u' => :upgrade
def upgrade
prepare :upgrade
say '✈ Upgrade fir-cli (use `gem install fir-cli --no-ri --no-rdoc`)'
say `gem install fir-cli --no-ri --no-rdoc`
end
desc 'version', 'Show fir-cli version number and quit (aliases: `v`).'
map ['v', '-v', '--version'] => :version
def version
say "✈ fir-cli #{FIR::VERSION}"
end
desc 'help', 'Describe available commands or one specific command (aliases: `h`).'
map Thor::HELP_MAPPINGS => :help
def help(command = nil, subcommand = false)
super
end
no_commands do
def invoke_command(command, *args)
logfile = options[:logfile].blank? ? STDOUT : options[:logfile]
logfile = '/dev/null' if options[:quiet]
FIR.logger = Logger.new(logfile)
FIR.logger.level = options[:verbose] ? Logger::DEBUG : Logger::ERROR
super
end
end
private
def prepare(task)
if options.help?
help(task.to_s)
raise SystemExit
end
$DEBUG = true if ENV['DEBUG']
end
end
end