AppBox Plugin for Fastlane

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

fastlane add_plugin appbox

Step 2 - Download the latest version of AppBox from here or here and install it into /Applications directory of you mac. Now, open AppBox and login with your Dropbox account.

Step 3 - Define appbox action in your project Fastfile with emails and message. Here the available params for appbox plugins -

• emails (Required | String) - Comma-separated list of email address that should receive application installation link.
• message (Optional | String) - Attach personal message in the email. Supported Keywords:

  The {PROJECT_NAME} - For Project Name,
  {BUILD_VERSION} - For Build Version, and
  {BUILD_NUMBER} - For Build Number.

• appbox_path (Optional | String) - If you've setup AppBox in the different directory then you need to mention that here. Default is /Applications/AppBox.app
• keep_same_link (Optional | Bool) - This feature will keep same short URL for all future build/IPA uploaded with same bundle identifier. If this option is enabled, you can also download the previous build with the same URL. Read more here.
• dropbox_folder_name (Optional | String) - You can change the link by providing a Custom Dropbox Folder Name. By default folder name will be the application bundle identifier. So, AppBox will keep the same link for the IPA file available in the same folder. Read more here.

default_platform(:ios)

platform :ios do
  lane :gymbox do
    gym
    appbox(
        emails: 'you@example.com',
    )
  end
end

default_platform(:ios)

platform :ios do
  lane :gymbox do
    gym
    appbox(
        emails: 'you@example.com,'someoneelse@example.com',
    )
  end
end

default_platform(:ios)

platform :ios do
  lane :gymbox do
    gym
    appbox(
        emails: 'you@example.com',
        message: '{PROJECT_NAME} - {BUILD_VERSION}({BUILD_NUMBER}) is ready to test.',
    )
  end
end

default_platform(:ios)

platform :ios do
  lane :gymbox do
    gym
    appbox(
        emails: 'you@example.com',
        message: '{PROJECT_NAME} - {BUILD_VERSION}({BUILD_NUMBER}) is ready to test.',
        keep_same_link: true,
    )
  end
end

default_platform(:ios)

platform :ios do
  lane :gymbox do
    gym
    appbox(
        emails: 'you@example.com',
        message: '{PROJECT_NAME} - {BUILD_VERSION}({BUILD_NUMBER}) is ready to test.',
        keep_same_link: true,
        dropbox_folder_name: 'Fastlane-Demo-Keep-Same-Link',
    )
  end
end

default_platform(:ios)

platform :ios do
  lane :gymbox do
    gym
    appbox(
        emails: 'you@example.com,'someoneelse@example.com',
        appbox_path:'/Users/vineetchoudhary/Desktop/AppBox2.8.0/AppBox.app',
    )
  end
end

• APPBOX_SHARE_URL - AppBox short shareable URL to install uploaded application.
• APPBOX_IPA_URL- Upload IPA file URL to download IPA file.
• APPBOX_MANIFEST_URL - Manifest file URL for upload application.
• APPBOX_LONG_SHARE_UR - AppBox long shareable URL to install uploaded application.

AppBox is a tool for iOS developers to build and deploy Development, Ad-Hoc and In-house (Enterprise) applications directly to the devices from your Dropbox account. Also, available on Github.

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

For any other issues and feedback about this plugin, please submit it to this repository.

If you have trouble using plugins, check out the Plugins Troubleshooting guide.