More than 5 years have passed since last update.

【Android】「自作ライブラリ」を「GitHub」に置いて「Gradle」でビルドするだけで利用できるようにする（2）

Last updated at 2018-01-10Posted at 2017-12-25

#あらすじ

前回、

【Android】「自作ライブラリ」を「GitHub」に置いて「Gradle」でビルドするだけで利用できるようにする（1）

では、「Android ライブラリ」を新規作成し、「AAR」ファイルを生成した。

次は――。

#（2）ローカル環境に「Maven リポジトリ」を作成する

作成した「AAR」を全世界に配布するには、全世界からアクセスできる「リポジトリ」が必要だ。

なので、その「リポジトリ」を「GitHub」に配置し公開する、というのが最終形になる。

手順としては、

1. ローカル環境に「Maven リポジトリ」を作成する
2. ローカル環境に作成した「Maven リポジトリ」を「GitHub」にアップロードし公開する

となる。

##（2.1）「build.gradle」に「Maven リポジトリ」作成スクリプトを追記する

「Maven リポジトリ」を生成する為には、「build.gradle」にスクリプトを追記する必要がある。

ここで生成される「Maven リポジトリ」は、前回作成した「AAR」ファイルを格納した状態になる。

まず、以下が、私作モジュールの最終的な（全世界に配信済みの）「build.gradle」の全内容だ。

apply plugin: 'com.android.library'

android {
    compileSdkVersion 26
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 26
        versionCode 7
        versionName "1.1.4"
        version = android.defaultConfig.versionName
    }
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    packagingOptions {
        exclude 'assets/*'
    }
    libraryVariants.all { variant ->
        variant.outputs.all { output ->
            output.packageLibrary.exclude("libs/*")
            if (variant.name == android.buildTypes.release.name) {
                outputFileName = output.outputFile.name.replace(("-release.aar"), "-${version}.aar")
            } else if (variant.name == android.buildTypes.debug.name) {
                outputFileName = output.outputFile.name.replace((".aar"), "-${version}.aar")
            }
        }
    }
}

dependencies {
    compileOnly fileTree(dir: 'libs', include: ['*.jar'])
}

def repo = new File(rootDir, "repository")

apply plugin: 'maven'

uploadArchives {
    repositories {
        mavenDeployer {
            repository url: "file://${repo.absolutePath}"
            pom.version = '1.1.4'
            pom.groupId = 'cutboss.support'
            pom.artifactId = 'review'
        }
    }
}

上記後半、以下の部分が、「Maven リポジトリ」作成スクリプトになっている。

def repo = new File(rootDir, "repository")

apply plugin: 'maven'

uploadArchives {
    repositories {
        mavenDeployer {
            repository url: "file://${repo.absolutePath}"
            pom.version = '1.1.4'
            pom.groupId = 'cutboss.support'
            pom.artifactId = 'review'
        }
    }
}

以下にて、補足の説明をする。

###（2.1.1）プロジェクトルートに「repository」フォルダを作成する

スクリプト冒頭の

def repo = new File(rootDir, "repository")

だが、「rootDir」というのはプロジェクトルートのことで、そこに、「repository」というフォルダを生成することを定義している。

この結果、

私作ライブラリ環境だと、↑こうなっている。

###（2.1.2）「pom（Maven 設定ファイル）」を作成する

「Android ライブラリ」を「Maven 形式」で配布する為に、「Maven プラグイン」を利用する。

apply plugin: 'maven'

今回追記するこのスクリプトを実行すると、「pom」と呼ばれるMavenの設定ファイルが生成される。

「pom」には、自作ライブラリの「バージョン」「グループドメイン」「ライブラリ名」を設定する必要がある。

uploadArchives {
    repositories {
        mavenDeployer {
            repository url: "file://${repo.absolutePath}"
            pom.version = '1.1.4'               // バージョン
            pom.groupId = 'cutboss.support'     // グループドメイン
            pom.artifactId = 'review'           // ライブラリ名
        }
    }
}

私の場合、既に、どのようにして全世界で使ってほしいかが、先行して頭の中にあって、

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'cutboss.support:review:1.1.4'
    implementation 'cutboss.support:util:1.0.0'
}

こういうイメージだった。

完全にイメージ先行で、こうするにはどうしなければならないのか、を考えた。

その結果、私の頭の中を実現すると、