teamsx plugin

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

fastlane add_plugin teamsx

Deliver message to MSTeams

Note to author: Add a more detailed description about this plugin here. If your plugin contains multiple actions, make sure to mention them here.

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.

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)

To run both the tests, and code style validation, run

rake

To automatically fix many of the styling issues, use

rubocop -a

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.

For more information about how the fastlane plugin system works, check out the Plugins documentation.

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.

Add the following lane to your Fastfile to use the TeamsX action:

lane :notify_teams do
  teamsx(
    # Required parameters
    title: "Release Notification",           # Used as fallback for main_title
    message: "A new version has been released!", # Used as fallback for body
    teams_url: "https://outlook.office.com/webhook/your-webhook-url",

    # Optional parameters for Adaptive Card
    main_title: "🚀 New Release!",           # Large header (optional)
    subtitle: "Production Deployment",       # Subtitle (optional)
    body: "Version 1.2.3 is now live.",     # Main body text (optional)
    mentions: [                              # Optional mentions (array of hashes)
      { "id" => "user-id-1", "name" => "Alice", "at_text" => "Alice" },
      { "id" => "user-id-2", "name" => "Bob", "at_text" => "Bob" }
    ],
    facts: [                                 # Optional facts (array of hashes)
      { "title" => "Environment", "value" => "Production" },
      { "title" => "Version", "value" => "1.2.3" }
    ]
  )
end

• Only title, message, and teams_url are required.
• All other parameters are optional and will be included in the Teams message if provided.
• If main_title or body are not provided, the action will use title and message as fallbacks.
• You can omit any section (subtitle, mentions, facts) and it will not appear in the card.