распространять библиотеку Android в jCenter для использования в Gradle

У меня есть проект библиотеки с модулем, который предназначен только для библиотечных классов и представлений. Я искал в интернете, как распространять его в jCenter, чтобы использовать в качестве зависимости gradle, но ничего не работает.

Хотя это еще не сделано, как я могу использовать этот модуль в других проектах?

PS: я использую Android Studio на Windows 10.

Ответы на вопрос(1)

Многие учебные пособия и инструкции онлайн устарели или им очень трудно следовать. Я только что научился делать это сам, поэтому я добавляю то, что, надеюсь, будет для вас быстрым решением. Включает в себя следующие пункты

Начните с вашей библиотеки AndroidНастройте учетную запись BintrayОтредактируйте файлы Gradle вашего проектаЗагрузите свой проект в BintrayСвяжите это с jCenterБиблиотека, которой вы хотите поделиться

К настоящему времени у вас, вероятно, уже есть настроенная библиотека. Ради этого примера я сделал новый проект с однимdemo-app модуль приложения и одинmy-library библиотечный модуль в Android Studio.

Вот как это выглядит при использовании представлений Project и Android:

Настройте учетную запись Bintray

В Bintray размещаются репозитории jCenter.Зайдите на Bintray и создайте бесплатный аккаунт.

После входа нажмитеДобавить новый репозиторий

Назовите хранилищеmaven, (Однако вы можете назвать это как-то иначе, если вы хотите сгруппировать несколько библиотечных проектов вместе. Если вы это сделаете, вам также потребуется изменитьbintrayRepo имя в файле Gradle ниже.)

Выбралиспециалист в качестве типа хранилища.

Вы можете добавить описание, если хотите. Затем нажмитеСоздайте, Это все, что нам нужно сделать в Bintray на данный момент.

Редактировать файлы Gradle

Я собираюсь сделать это как можно более вырезанным и вставленным, но не забудьте отредактировать необходимые детали. Вам не нужно ничего делать с модулем демо-приложенияbuild.gradle файл, только файлы Gradle для проекта и библиотеки.

Проект build.gradle

Добавьте плагины Bintray и Mavin в свой проектbuild.gradle файл. Вот весь мой файл:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.3.2'

        // Add these lines (update them to whatever the newest version is)
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

Новейшая версия дляБинтрей здесь а такжеMaven здесь.

Библиотека build.gradle

Отредактируйте все, что вам нужно вext блок ниже.

apply plugin: 'com.android.library'

// change all of these as necessary
ext {
    bintrayRepo = 'maven'  // this is the same as whatever you called your repository in Bintray
    bintrayName = 'my-library' // your bintray package name. I am calling it the same as my library name.

    publishedGroupId = 'com.example'
    libraryName = 'my-library'
    artifact = 'my-library' // I'm calling it the same as my library name

    libraryDescription = 'An example library to make your programming life easy'

    siteUrl = 'https://github.com/example/my-library'
    gitUrl = 'https://github.com/example/my-library.git'

    libraryVersion = '1.0.0'

    developerId = 'myID' // Maven plugin uses this. I don't know if it needs to be anything special.
    developerName = 'My Name'
    developerEmail = '[email protected]'

    licenseName = 'The MIT License (MIT)'
    licenseUrl = 'https://opensource.org/licenses/MIT'
    allLicenses = ["MIT"]
}

// This next section is your normal gradle settings
// There is nothing special that you need to change here
// related to Bintray. Keep scrolling down.

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.2"

    defaultConfig {
        minSdkVersion 9
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:25.3.1'
    testCompile 'junit:junit:4.12'
}

// Maven section
// You shouldn't need to change anything. It just uses the
// values you set above.

apply plugin: 'com.github.dcendents.android-maven'

group = publishedGroupId // Maven Group ID for the artifact

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                groupId publishedGroupId
                artifactId artifact

                // Add your description here
                name libraryName
                description libraryDescription
                url siteUrl

                // Set your license
                licenses {
                    license {
                        name licenseName
                        url licenseUrl
                    }
                }
                developers {
                    developer {
                        id developerId
                        name developerName
                        email developerEmail
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl

                }
            }
        }
    }
}

// Bintray section
// As long as you add bintray.user and bintray.apikey to the local.properties
// file, you shouldn't have to change anything here. The reason you 
// don't just write them here is so that they won't be publicly visible
// in GitHub or wherever your source control is.

apply plugin: 'com.jfrog.bintray'

version = libraryVersion

if (project.hasProperty("android")) { // Android libraries
    task sourcesJar(type: Jar) {
        classifier = 'sources'
        from android.sourceSets.main.java.srcDirs
    }

    task javadoc(type: Javadoc) {
        source = android.sourceSets.main.java.srcDirs
        classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
    }
} else { // Java libraries
    task sourcesJar(type: Jar, dependsOn: classes) {
        classifier = 'sources'
        from sourceSets.main.allSource
    }
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives javadocJar
    archives sourcesJar
}

Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())

bintray {
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")

    configurations = ['archives']
    pkg {
        repo = bintrayRepo
        name = bintrayName
        desc = libraryDescription
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = allLicenses
        publish = true
        publicDownloadNumbers = true
        version {
            desc = libraryDescription
            gpg {
                // optional GPG encryption. Default is false.
                sign = false
                //passphrase = properties.getProperty("bintray.gpg.password")
            }
        }
    }
}
local.properties

Библиотекаbuild.gradle файл выше ссылался на некоторые значения вlocal.properties файл. Нам нужно добавить их сейчас. Этот файл находится в корне вашего проекта. Это должно быть включено в.gitignore, (Если это не так, добавьте его.) Смысл в том, чтобы указать здесь свое имя пользователя, ключ API и пароль шифрования, чтобы он не был публично виден при управлении версиями.

## This file is automatically generated by Android Studio.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
#
# This file should *NOT* be checked into Version Control Systems,
# as it contains information specific to your local configuration.
#
# Location of the SDK. This is only used by Gradle.
# For customization when using a Version Control System, please read the
# header note.
sdk.dir=/home/yonghu/Android/Sdk

# Add these lines (but change the values according to your situation)
bintray.user=myusername
bintray.apikey=1f2598794a54553ba68859bb0bf4c31ff6e71746

Есть предупреждение о том, что этот файл не нужно изменять, но он все равно работает хорошо. Вот как вы получаете значения:

bintray.user: Это ваше имя пользователя Bintray.bintray.apikey: Идти кРедактировать профиль в меню Bintray и выберитеКлюч API, Скопируйте это отсюда.

Загрузить проект в Bintray

Откройте терминал и перейдите в корневую папку вашего проекта. Или просто используйте терминал в Android Studio.

Введите следующие команды

./gradlew install
./gradlew bintrayUpload

Если все настроено правильно, загрузите вашу библиотеку в Bintray. Если это не удается, то Google решение. (Мне пришлось обновить мой JDK при первой попытке.)

Перейдите в свою учетную запись в Bintray, и вы должны увидеть библиотеку, введенную в вашем хранилище.

Ссылка на jCenter

В вашей библиотеке в Bintray естьДобавить в jCenter кнопка.

Нажмите на нее и отправьте запрос. Если вы одобрены (это занимает день или два), то ваша библиотека станет частью jCenter, и разработчики по всему миру могут добавить вашу библиотеку в свои проекты, просто добавив одну строку в приложениеbuild.gradle блок зависимостей.

dependencies {
    compile 'com.example:my-library:1.0.0'
}

Поздравляем!

ЗаметкиВы можете добавить шифрование PGP, особенно если вы связываете его с Maven Central. (jCenter заменил Maven Central по умолчанию в Android Studio.) См.этот урок за помощь с этим. Но такжепрочитай это из Бинтре.Как добавить новую версию

В конечном итоге вы захотите добавить новую версию в вашу библиотеку Bintray / jCenter. Увидетьэтот ответ к указаниям о том, как это сделать.

Дальнейшее чтениеКак распространять свою собственную библиотеку Android через jCenter и Maven Central из Android StudioСоздание и публикация библиотеки Android
 Ehtesham Hasan31 мар. 2018 г., 08:19
@Suragch Такжеversion = libraryVersion version не используется.
 Suragch31 мар. 2018 г., 16:02
@EhteshamHasan , спасибо за обновление.
 Ehtesham Hasan31 мар. 2018 г., 08:10
@Suragch Зачем нужна эта линия?group = publishedGroupId Вы не используетеgroup в любом другом месте.
 Suragch14 дек. 2017 г., 15:02
@ Саймон, да, это была большая боль, чтобы настроить в первый раз. Но после этого все не так плохо. Проверять, выписыватьсямой другой ответ когда вам нужно обновить библиотеку. Это процесс, которым я следую каждый раз.
 Ehtesham Hasan31 мар. 2018 г., 15:40
@Surahchgroup = publishedGroupId а такжеversion = libraryVersion строки необходимы, если имя вашего библиотечного модуля в Android Studio не совпадает с artifactId. Больше информации здесь:github.com/bintray/gradle-bintray-plugin/issues/81
 Suragch31 мар. 2018 г., 09:45
@EhteshamHasan, хороший вопрос. Они могут быть ненужными артефактами, когда я только начинал это делать. Если вы обнаружите, так или иначе, пожалуйста, оставьте другой комментарий. Я могу попробовать удалить их также в будущем обновлении библиотеки.
 Rahul Rastogi28 июл. 2018 г., 20:22
Если кто-то сталкивается с проблемами, связанными с генерацией Javadoc при загрузке на bintray. Чтобы это исправить, вы можете удалить связанный с javadoc код из файла build.gradle вашего модуля. Но обратите внимание, что, если вы хотите распространять его на mavel central, тогда потребуется javadoc.
 Suragch16 мая 2017 г., 07:02
@Франко, мне нужно еще кое-что изучить, прежде чем я смогу ответить.
 Simon K. Gerges14 дек. 2017 г., 13:49
Большое спасибо, я устал от многих попыток, наконец, ты сделал мой день
 Franco15 мая 2017 г., 10:13
Я видел этот код в нескольких местах, но я немного запутался в некоторых вещах, возможно, вы можете ответить на них: 1. Почему существует задача, называемаяsourcesJar? Это звучит какjar будет загружен в Bintray вместоaar, что звучит запутанно. 2. Как «maven part» соединяется с «bintray part»? Я не могу найти никаких связей между ними, например, загружен ли POM в Bintray? И если да, то как он определяется задачами Bintray?

Ваш ответ на вопрос