semantic_release plugin for `fastlane`

Getting Started

fastlane add_plugin semantic_release

About

Automated version managment and generator of release notes. Inspired by semantic-release for npm packages. Based on conventional commits.

Articles

Semantic Release for Fastlane @ Medium - By Jiri Otahal

Available Actions

conventional_changelog

parses all commits since last version
group those commits by their type (fix, feat, docs, refactor, chore, etc)
and creates formated release notes either in markdown or in slack format

notes = conventional_changelog(format: 'slack', title: 'Android Alpha')

analyze_commits

analyzes your git history
finds last tag on current branch (for example ios/beta/1.3.2)
parses the last version from tag (1.3.2)
gets all commits since this tag
analyzes subject of every single commit and increases version number if there is a need (check conventional commit rules)
if next version number is higher then last version number it will recommend you to release this version isReleasable = analyze_commits(match: 'ios/beta*')

It provides these variables in lane_context.

['RELEASE_ANALYZED', 'True if commits were analyzed.'],
['RELEASE_IS_NEXT_VERSION_HIGHER', 'True if next version is higher then last version'],
['RELEASE_LAST_TAG_HASH', 'Hash of commit that is tagged as a last version'],
['RELEASE_LAST_VERSION', 'Last version number - parsed from last tag.'],
['RELEASE_NEXT_MAJOR_VERSION', 'Major number of the next version'],
['RELEASE_NEXT_MINOR_VERSION', 'Minor number of the next version'],
['RELEASE_NEXT_PATCH_VERSION', 'Patch number of the next version'],
['RELEASE_NEXT_VERSION', 'Next version string in format (major.minor.patch)'],

next_version = lane_context[SharedValues::RELEASE_NEXT_VERSION]

Questions

If you need anything ping us on twitter.

Jiri Otahal

semantic_release plugin for fastlane