No description, website, or topics provided.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
fastlane
lib/fastlane/plugin
spec
.gitignore
.rspec
.rubocop.yml
.travis.yml
Gemfile
Gemfile.lock
LICENSE
README.md
Rakefile
fastlane-plugin-tpa.gemspec

README.md

TPA plugin

Build Status Gem fastlane Plugin Badge

TPA gives you advanced user behaviour analytics, app distribution, crash analytics and more.

Getting Started | Overview | Issues and Feedback | License

Getting Started

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

fastlane add_plugin tpa

Overview

This plugin makes interacting with TPA easy by providing you actions to upload .ipa, .apk and .dSYM files directly to TPA.

In particular, this plugin provides the following two actions:

  • upload_to_tpa: uploads either an iOS .ipa app together with its corresponding dSYM to TPA. It is also capable of uploading an Android .apk app to TPA.
  • upload_symbols_to_tpa: Uploads only dSYM files to TPA

upload_to_tpa

Use the upload_to_tpa action (or the alias tpa) in order to upload an app to TPA. A common building lane would look something like the following:

desc 'Builds a beta version of the app and uploads it to TPA'
lane :beta do
  build_app                  # Builds the app
  upload_to_tpa              # Uploads the app and dSYM files to TPA
end

upload_symbols_to_tpa

If you have bitcode enabled in your iOS app, then you will need to download the dSYM files from App Store Connect and upload them to TPA so that the crash reports can be symbolicated. In order to help with this process, then you can make use of the upload_symbols_to_tpa action.

This action should be part of the download_dsyms action which is part of Fastlane.

We recommend setting up a CI server which runs on a regular basis (for example once every night) to refresh the dSYM files. Such a lane could look like the following:

desc 'Downloads the dSYM files from App Store Connect and uploads them to TPA'
lane :refresh_dsym do
  download_dsyms             # Download dSYM files from App Store Connect
  upload_symbols_to_tpa      # Upload them to TPA
  clean_build_artifacts      # Delete the local dSYM files
end

Instead of downloading all the dSYM files, then an alternative lane could look like the following:

desc 'Downloads the dSYM files from App Store Connect and uploads them to TPA'
lane :refresh_dsym do
  download_dsyms(version: 'latest')    # Download dSYM files from App Store Connect
  upload_symbols_to_tpa                # Upload them to TPA
  clean_build_artifacts                # Delete the local dSYM files
end

Available for tpa.io Domains

If you are using a managed version of TPA (for example {your-subdomain.tpa.io}, then feel free to use the latest version of this plugin. In your Pluginfile it should simply be written:

gem 'fastlane-plugin-tpa'

If you do not have a tpa.io domain, you will need to use version 1.x.x of this plugin. You can install version 1.x.x by specifying the following in your Pluginfile:

gem 'fastlane-plugin-tpa', '~>1.0'

Example

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.

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.

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.

License

MIT