All Projects β†’ riiid β†’ Gradle Github Plugin

riiid / Gradle Github Plugin

Licence: apache-2.0
🚚 Gradle plugin for Github releases

Programming Languages

groovy
2714 projects

gradle-github-plugin

Download Android Arsenal

🚚 Gradle plugin for Github releases.
You can fully automate releases via gradle-github-plugin. πŸš€

Supported features

  • Create a release
  • Upload your files and/or directories!!! πŸ’₯πŸ’₯πŸ’₯

Usage

There are two ways.

1. jcenter

Edit your build.gradle file.
Add jcenter(), classpath ... to repositories, dependencies in buidlscript respectively.

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        ...
        classpath 'co.riiid:gradle-github-plugin:X.Y.Z'
        ...
    }
}

And add apply plugin.

apply plugin: 'co.riiid.gradle'

2. plugins.gradle.org (easy)

Plugin mechanism introduced in Gradle 2.1+

plugins {
  id "co.riiid.gradle" version "X.Y.Z"
}

Add github configuration and set properties if you've done with 1 or 2.

Supported Properties

Name Type Description
baseUrl String Optional. The URL of Github. You can change this url as yours if you use Github Enterprise. (Default: https://api.github.com)
owner String Required. The id of your Github.
repo String Required. The name of your Github's repository.
token String Required. Github access token. Generate yours in Settings/Tokens
tagName String Required. The name of the tag.
targetCommitish String Default is master. Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository’s default branch (usually master).
name String Optional. The name of the release.
body String Optional. Text describing the contents of the tag.
prerelease boolean Optional. true to create a draft (unpublished) release, false to create a published one. Default: false
draft boolean Optional. true to identify the release as a prerelease. false to identify the release as a full release. Default: false

Example

github {
    owner = 'riiid'
    repo = 'gradle-github-plugin'
    token = 'XXXXXXXXXXXXXXXXXXXXX'
    tagName = '0.1.0'
    targetCommitish = 'master'
    name = 'v0.1.0'
    body = """# Project Name
Write `release note` here.
"""
    assets = [
            'app/build/outputs/apk/app-release.apk',
            'app/build/outputs/mapping/release/mapping.txt',
            'app/build/outputs',
            ...
    ]
}

If an asset is directory, gradle-github-plugin will zip the directory, <dir-name>.zip by name.
For example, app/build/outputs is compressed into app/build/outputs.zip. The file will be removed after uploaded.

Finally you can see githubRelease task

$ ./gradlew tasks | grep githubRelease
githubRelease

Run the task!!!

$ ./gradlew githubRelease

Good luck!!!

References

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].