cieslakdawid / fastlane-plugin-slack_upload

Fastlane plugin to upload files to Slack

slack_upload plugin

This plugin simply uploads a given file to your Slack.

Sometimes as part of CI builds you want to generate some files from the project that might be valuable for your team. You can think about documentation or screenshots of the application on different devices. With slack_uplaod it's easy to send them to dedicated Slack channel or directly to your teammates.

Note: Fastlane comes with slack plugin by default, although it uses slack-notifier API that doesn't support uploading files.

Getting Started

1. Generate Slack token for Fastlane bot

   • From your Slack organization page, go to Manage -> Custom Integrations
   • Open Bots
   • Add Configuration
   • Choose a name for your bot, e.g. "fastlane"
   • Save API Token

2. Add plugin to fastlane

fastlane add_plugin slack_upload

3. Add slack_upload to your lane in Fastfile whenever you want to upload the file

In the following example we generate screenshots (More info) and send them to #general channel

lane :screenshots_lane do

    version = get_version_number

    # Generate screenshots
    capture_screenshots

    # Zip screenshots folder
    zip(
      path: "./fastlane/screenshots",
      output_path: "./fastlane/screenshots.zip"
    )

    # Upload to slack
    slack_upload(
            slack_api_token: "xyz", # Preferably configure as ENV['SLACK_API_TOKEN']
            title: "New version #{version} is available ",
            channel: "#general",
            file_path: "./fastlane/screenshots.zip",
            initial_comment: "Changelog goes here"
    ) 
  end

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 guide.

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 beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.

fastlane-plugin-slack_upload's Issues

Getting this error `Exception: unavailable_error`

Of late, l do get this error while uploading to slack channel. Does anyone knows how to go about this?

Exception: `invalid_auth`

I followed #1 but could not get it to work.

I get invalid_auth exception when trying to upload.
When creating an app-level token I can only select 2 scopes authorizations:read, connections:write

Slack has changed its use of Custom Integrations

Do you have a way to use Slack nowadays,

The custom integrations page says we now have to create custom apps, I dont see any API keys

We recommend replacing your custom integrations with Slack apps, which have more features and use the latest APIs. Learn more about switching to Slack apps.

Exception: not_in_channel

I created a bot, gave it the following oauth permissions

chat:write
Send messages as @mojave_fastlane_notif

files:write
Upload, edit, and delete files as Mojave Fastlane Notifications

incoming-webhook
Post messages to specific channels in Slack

Installed the app, put it in #mychannel got the API key, set up slack_upload with

    slack_upload(
      slack_api_token: "xxxxxxxx", # Preferably configure as ENV['SLACK_API_TOKEN']
      title: "New Android build is available",
      channel: "#mychannel",
      file_path: "./app/build/outputs/apk/myapp/release/app-myapp-release.apk",
      # initial_comment: "Changelog goes here"
    ) 

and I get this error.

Exception: not_in_channel

Can we get some clarification on setting up this plugin?