# fastlane-plugin-polidea

[![build status](https://gitlab2.polidea.com/CI/fastlane-plugin-polidea/badges/master/build.svg)](https://gitlab2.polidea.com/CI/fastlane-plugin-polidea)
[![Gem](https://img.shields.io/gem/v/fastlane-plugin-polidea.svg?style=flat)](http://rubygems.org/gems/fastlane-plugin-polidea)


## Getting Started

This project is a [fastlane](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-polidea`, add it to your project by running:

```bash
fastlane add_plugin polidea
```

## Available actions

Plugin contains following actions:
- `extract_app_name`: Extracts application name from .apk/.ipa
- `extract_app_icon`: Extracts largest icon from .ipa/.apk
- `extract_version`: Extracts app version and build number from .ipa/.apk
- `get_binary_size`: Measures binary size in bytes
- `s3`: Custom version of s3 action with Polidea's installation page
- `fota_mail`: Custom version of mailgun action with Polidea's mail template

See more details [here](https://gitlab2.polidea.com/CI/fastlane-plugin-polidea/blob/master/docs/Actions.md).
To list all available actions run:
```bash
fastlane actions
```

## Example

```ruby
lane :deploy do
  (some actions that produces .ipa/.apk)
  extract_app_name
  extract_app_icon
  extract_version
  get_binary_size
  s3
  fota_mail(
    to: "piotr.dubiel@polidea.com"
  )
end
```

Check out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plugin. Try it by cloning the repo, running `fastlane install_plugins` and `bundle exec fastlane [android|ios] test`.

**Note to author:** Please set up a sample project to make it easy for users to explore what your plugin does. Provide everything that is necessary to try out the plugin in this project (including a sample Xcode/Android project if necessary)

## Troubleshooting

If you have trouble using plugins, check out the [Plugins Troubleshooting](https://github.com/fastlane/fastlane/blob/master/fastlane/docs/PluginsTroubleshooting.md) doc in the main `fastlane` repo.

## Using `fastlane` Plugins

For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Plugins.md).

## About `fastlane`

`fastlane` is the easiest way to automate building and releasing your iOS and Android apps. To learn more, check out [fastlane.tools](https://fastlane.tools).

## Development

### 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
```