Important
For the reason of fir.im had changed the Base URL, pls set firim_api_url to https://fir-api.fircli.cn/ or https://api.bq04.com. issue
From v0.2.5, the default firim_api_url set to https://api.bq04.com.
From firim v0.2.6, add show download url in terminal. issue
Firim
Firim is a command tool to directly upload ipa and change app infomation on fir.im. fir.im is a Beta APP host website, you can upload ipa for AdHoc or InHouse distribution for testing.
Getting Started
Add this line to your application's Gemfile:
gem 'firim'And then execute:
$ bundle
Or install it yourself as:
$ gem install firim
Quick Start
cd [your_project_folder]firim init- Enter your fir.im API Token (From Fir.im)
firim -i [your_ipa_path]
Usage
Use with fastlane fastlane-plugin-firim
You can specify the app infomations in Firimfile, To get a list of available options run
firim --help
Upload with icon NOTICE: Icon must be jpg format
firim -i [your_ipa_path] -l [your_icon_path]
Use firim_api_url to set API URL, if fir.im change the Base URL. default is https://api.fir.im.
Export environments
After upload app to fir.im, firim will export some environment variables.
-
FIRIM_APP_SHORTapp's short path -
FIRIM_APP_NAMEapp's name -
FIRIM_MASTER_RELEASE_IDapp's master_release_id -
FIRIM_APP_URLthe download page of the app
All other App Info export as FIRIM_#{key}, like FIRIM_icon_url
Assign API Token
There are three ways to assign Firim API Token
- Set
FIRIM_TOKENenvironment variables - Add
tokentomacOS Keychain - Set in
Firimfile
Firim will check the value from 1 to 3. Run Firim will add token to keychain in interactive shell. Also can use firim addtoken and firim removetoken to add or remove token.
Need help?
Please submit an issue on GitHub and provide information about your setup
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/whlsxl/firim. This project is intended to be a safe, welcoming space for collaboration.
License
The gem is available as open source under the terms of the MIT License.
TODO
- Generate a web page show all the app's link and infomations
- Show the app list, and export all app infomations to a file
- force reset icon