Fastlane Applivery plugin

fastlane Plugin Badge Gem Version

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-applivery, add it to your project by running:

fastlane add_plugin applivery

About Applivery.com

With Applivery.com you can easily distribute your iOS and Android Apps throughout a customizable platform with no need of your users have to be registered on it.

The main purpose of this plugin is to upload a new iOS or Android build to Applivery.com.

If you usually use Fastlane tools to automate the most common development tasks now you can start using out Fastlane Plugin to easily deploy new iOS and Android versions of your Apps to Applivery and close your development the cycle: Build, Test & deploy like a pro!

This fastlane plugin will also help you to have more context about the build, attaching and displaying the most relevant information: Direct link to the repository(GitHub & Bitbucket), commit hash, Branch, Tag, etc:

List of builds Build details

Examples

Below you'll find some basic examples about how to build a new iOS or Android App and automatically deploy it into Applivery.com

iOS App build and deploy

Next you'll find a lane with two steps: gym() that will build the iOS App and applivery() that will take care about the deployment.

lane :applivery_ios do
  gym(
    scheme: "YOUR_APP_SCHEME",        # Your App Scheme
    export_method: 'enterprise')      # Choose between: enterprise or ad-hoc
  applivery(
    app_id: "YOUR_APP_ID",            # Your Applivery App Id
    api_key: "YOUR_API_KEY"           # Your Applivery API Key
  )
end

Android App build and deploy

Next you'll find a lane with two steps: gradle() that will build the Android App and applivery() that will take care about the deployment.

lane :applivery_android do
  gradle(task: "assembleRelease")
  applivery(
    app_id: "YOUR_APP_ID",           # Your Applivery App Id
    api_key: "YOUR_API_KEY"          # Your Applivery API Key
  )
end

Please check out the example Fastfile to see additional examples of how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

Additional Parameters

The above examples are the most simple configuration you can have but in addition to the app_id and api_key parameters, you can add additional ones to fully customize the deployment process. They are:

Param Description Mandatory Values
app_id Applivery App ID YES string -> Available in the App details
api_key Applivery API Key YES string -> Available the Developers area
name Applivery Build name NO string. i.e.: "RC 1.0"
notify Notify users after deploy NO true / false
notes Release notes NO string. i.e.: "Bug fixing"
tags Tags to identify the build NO string comma separated. i.e.: "RC1, QA"
autoremove Remove the last build NO true / false
build_path Build path to the APK / IPA file NO string, by default it takes the IPA/APK build path

Run tests for this plugin

To run both the tests, and code style validation, run

rake

To automatically fix many of the styling issues, use

rubocop -a

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository or contact us at [email protected]

Troubleshooting

If you have trouble using plugins, check out the Plugins Troubleshooting doc in the main fastlane repo.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate building and releasing your iOS and Android apps. To learn more, check out fastlane.tools.