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_SHORT
app's short path -
FIRIM_APP_NAME
app's name -
FIRIM_MASTER_RELEASE_ID
app's master_release_id -
FIRIM_APP_URL
the 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_TOKEN
environment variables - Add
token
tomacOS 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