Generates a plist file and uploads all to AWS S3

Please use the aws_s3 plugin instead. Install using fastlane add_plugin aws_s3.

Upload a new build to Amazon S3 to distribute the build to beta testers. Works for both Ad Hoc and Enterprise signed applications. This step will generate the necessary HTML, plist, and version files for you. It is recommended to not store the AWS access keys in the Fastfile. The uploaded version.json file provides an easy way for apps to poll if a new update is available.

Supported platforms ios
Author @joshdholtz

2 Examples

  # All of these are used to make Shenzhen's `ipa distribute:s3` command
  access_key: ENV["S3_ACCESS_KEY"],     # Required from user.
  secret_access_key: ENV["S3_SECRET_ACCESS_KEY"], # Required from user.
  bucket: ENV["S3_BUCKET"],   # Required from user.
  ipa: "AppName.ipa",         # Optional is you use `ipa` to build
  dsym: "AppName.app.dSYM.zip",         # Optional is you use `ipa` to build
  path: "v{CFBundleShortVersionString}_b{CFBundleVersion}/", # This is actually the default.
  upload_metadata: true,      # Upload version.json, plist and HTML. Set to false to skip uploading of these files.
  version_file_name: "app_version.json",# Name of the file to upload to S3. Defaults to "version.json"
  version_template_path: "path/to/erb"  # Path to an ERB to configure the structure of the version JSON file


Key Description
ipa .ipa file for the build
dsym zipped .dsym package for the build
upload_metadata Upload relevant metadata for this build
plist_template_path plist template path
plist_file_name uploaded plist filename
html_template_path html erb template path
html_file_name uploaded html filename
version_template_path version erb template path
version_file_name uploaded version filename
access_key AWS Access Key ID
secret_access_key AWS Secret Access Key
bucket AWS bucket name
region AWS region (for bucket creation)
path S3 'path'. Values from Info.plist will be substituted for keys wrapped in
source Optional source directory e.g. ./build
acl Uploaded object permissions e.g public_read (default), private, public_read_write, authenticated_read

To show the documentation in your terminal, run

fastlane action s3

View source code

Back to actions