相关术语介绍

在我们开始之前，还有一些术语，需要熟悉下。

项目Project  –  在 Android Studio 中，一个 项目 就是一个完整的 Android app。Android Studio 项目包含了一个或多个模块。 在 Android Studio 中，一个 项目 类似于在 Eclipse 的一个工作区间workspace。

模块Module – 一个 模块 是 app 中的一个组件，它可以单独的进行构建、测试和调试。模块包含了 app 的源代码和资源文件。在 Android Studio 中，一个 模块 类似于在 Eclipse 的一个项目。

AAR – ‘aar’ 套件是 Android 开发库项目的二进制的分发形式。（）开发库项目的主要产出就是 .aar 包（意思是 Android 压缩包）。它是由编译后的代码（如 jar 文件或者 .so 文件）和资源文件（如 manifest 文件、res 文件、asset 文件）组合而成的。

Maven 中央仓库 – 由 Maven 社区提供的仓库。它包含了很多我们常用的开发库。  网站可用来浏览 maven 中央仓库的内容。 网站是另一个可用来搜索中央仓库的工具。如果你在项目配置文件的仓库配置部分添加了 jCenter() ，那么 Gradle 将使用 jCenter 仓库( )。Maven 中央仓库也经常被称作 Maven 中心或者中央仓库。

Sonatype — Sonatype的开源软件仓库托管（OSSRH）服务是项目作者和贡献者们发布他们的组件到中央仓库的主要途径。它是 Sonatype Nexus Professional 组织利用  工具，对开源项目提供部署托管服务，该服务主要用来处理部署和验证操作，也提供同步操作将内容通过网络投递到中央仓库。

GPG –  隐私保护组织 （也称为 GPG 或者 GnuPG），这个 是一个加密软件，遵循 OpenPGP （）标准，是 PGP 的免费替代品。使用 GPG 你可以加密（解密）包含的文件，比如那些由健康保险携带和责任法案 （） 制定的受保护的隐私和安全方面的电子健康信息。想了解 GPG 的更多信息，请访问 。

准备好你的 Android 开发库

我将使用我的  开发库作例子来讲解。在你的项目中，需要修改一些地方，来准备作为一个开发库发布到 Maven 中央仓库中。

将开发库的核心代码和示例代码区分开来。在我的项目中，我将他们分成 library 和 sample 两个模块。请仔细阅读关于创建一个的技巧。你也可能需要。

在 sample 模块的 build.gradle 文件中，请确保包含以下内容：

1. apply plugin: 'com.android.application'
2. dependencies {
3. compile project(':library')
4. }

在 library 模块的 build.gradle 文件中，请确保包含以下内容： 

1. apply plugin: 'com.android.library'
2. apply from: 'maven-push.gradle'

在 library 模块中，增加 gradle.properties 文件，请确保在该文件中包含以下内容：

1. POM_NAME=ProjectName
2. POM_ARTIFACT_ID=projectname
3. POM_PACKAGING=aar

在 library 模块中，增加 maven-push.gradle 文件，请确保在该文件中包含以下内容： 

1. /*
2. * Copyright 2013 Chris Banes
3. *
4. * Licensed under the Apache License, Version 2.0 (the "License");
5. * you may not use this file except in compliance with the License.
6. * You may obtain a copy of the License at
7. *
8. * http://www.apache.org/licenses/LICENSE-2.0
9. *
10. * Unless required by applicable law or agreed to in writing, software
11. * distributed under the License is distributed on an "AS IS" BASIS,
12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13. * See the License for the specific language governing permissions and
14. * limitations under the License.
15. */
17. apply plugin: 'maven'
18. apply plugin: 'signing'
20. def isReleaseBuild() {
21. return VERSION_NAME.contains("SNAPSHOT") == false
22. }
24. def getReleaseRepositoryUrl() {
25. return hasProperty('RELEASE_REPOSITORY_URL') ? RELEASE_REPOSITORY_URL
26. : "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
27. }
29. def getSnapshotRepositoryUrl() {
30. return hasProperty('SNAPSHOT_REPOSITORY_URL') ? SNAPSHOT_REPOSITORY_URL
31. : "https://oss.sonatype.org/content/repositories/snapshots/"
32. }
34. def getRepositoryUsername() {
35. return hasProperty('NEXUS_USERNAME') ? NEXUS_USERNAME : ""
36. }
38. def getRepositoryPassword() {
39. return hasProperty('NEXUS_PASSWORD') ? NEXUS_PASSWORD : ""
40. }
42. afterEvaluate {
    project ->
43. uploadArchives {
44. repositories {
45. mavenDeployer {
46. beforeDeployment {
    MavenDeployment deployment -> signing.signPom(deployment) }
48. pom.groupId = GROUP
49. pom.artifactId = POM_ARTIFACT_ID
50. pom.version = VERSION_NAME
52. repository(url: getReleaseRepositoryUrl()) {
53. authentication(userName: getRepositoryUsername(), password: getRepositoryPassword())
54. }
55. snapshotRepository(url: getSnapshotRepositoryUrl()) {
56. authentication(userName: getRepositoryUsername(), password: getRepositoryPassword())
57. }
59. pom.project {
60. name POM_NAME
61. packaging POM_PACKAGING
62. description POM_DESCRIPTION
63. url POM_URL
65. scm {
66. url POM_SCM_URL
67. connection POM_SCM_CONNECTION
68. developerConnection POM_SCM_DEV_CONNECTION
69. }
71. licenses {
72. license {
73. name POM_LICENCE_NAME
74. url POM_LICENCE_URL
75. distribution POM_LICENCE_DIST
76. }
77. }
79. developers {
80. developer {
81. id POM_DEVELOPER_ID
82. name POM_DEVELOPER_NAME
83. }
84. }
85. }
86. }
87. }
88. }
90. signing {
91. required {
    isReleaseBuild() && gradle.taskGraph.hasTask("uploadArchives") }
92. sign configurations.archives
93. }
95. //task androidJavadocs(type: Javadoc) {
96. //source = android.sourceSets.main.allJava
97. //}
99. //task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
100. //classifier = 'javadoc'
101. //from androidJavadocs.destinationDir
102. //}
104. task androidSourcesJar(type: Jar) {
105. classifier = 'sources'
106. from android.sourceSets.main.java.sourceFiles
107. }
109. artifacts {
110. archives androidSourcesJar
111. }
112. }

修改在项目根目录的 .gitignore 文件 

1. # [Android] ========================
2. # Built application files
3. *.apk
4. *.ap_
6. # Files for the Dalvik VM
7. *.dex
9. # Java class files
10. *.class
12. # Generated files
13. bin/
14. gen/
16. # Gradle files
17. .gradle/
18. build/
20. # Local configuration file (sdk path, etc)
21. local.properties
23. # Proguard folder generated by Eclipse
24. proguard/
26. # Log Files
27. *.log
29. ## Directory-based project format:
30. .idea/
32. ## File-based project format:
33. *.ipr
34. *.iws
36. ## Plugin-specific files:
38. # IntelliJ
39. out/
41. # mpeltonen/sbt-idea plugin
42. .idea_modules/
44. # JIRA plugin
45. atlassian-ide-plugin.xml
47. # Crashlytics plugin (for Android Studio and IntelliJ)
48. com_crashlytics_export_strings.xml
50. # [Maven] ========================
51. target/
52. pom.xml.tag
53. pom.xml.releaseBackup
54. pom.xml.versionsBackup
55. pom.xml.next
56. release.properties
58. # [Gradle-Android] ========================
60. # Ignore Gradle GUI config
61. gradle-app.setting
63. # Gradle Signing
64. signing.properties
65. trestle.keystore
67. # Mobile Tools for Java (J2ME)
68. .mtj.tmp/
70. # Package Files #
71. *.jar
72. *.war
73. *.ear
75. # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
76. hs_err_pid*
78. # Misc
79. /.idea/workspace.xml
80. .DS_Store
81. /captures
82. **/*.iml
83. *.class

修改在项目根目录的 settings.gradle 文件 

1. include ':sample', ':library'

修改在项目根目录的 gradle.properties 文件

1. # Project-wide Gradle settings.
3. # IDE (e.g. Android Studio) users:
4. # Gradle settings configured through the IDE *will override*
5. # any settings specified in this file.
7. # For more details on how to configure your build environment visit
8. # http://www.gradle.org/docs/current/userguide/build_environment.html
10. # Specifies the JVM arguments used for the daemon process.
11. # The setting is particularly useful for tweaking memory settings.
12. # Default value: -Xmx10248m -XX:MaxPermSize=256m
13. # org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
15. # When configured, Gradle will run in incubating parallel mode.
16. # This option should only be used with decoupled projects. More details, visit
17. # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
18. # org.gradle.parallel=true
20. VERSION_NAME=0.0.1
21. VERSION_CODE=1
22. GROUP=com.github.github_username
24. POM_DESCRIPTION=A library that does X, Y, and Z
25. POM_URL=https://github.com/github_username/ProjectName
26. POM_SCM_URL=https://github.com/github_username/ProjectName
27. POM_SCM_CONNECTION=scm:git@github.com:github_username/ProjectName.git
28. POM_SCM_DEV_CONNECTION=scm:git@github.com:github_username/ProjectName.git
29. POM_LICENCE_NAME=The Apache Software License, Version 2.0
30. POM_LICENCE_URL=http://www.apache.org/licenses/LICENSE-2.0.txt
31. POM_LICENCE_DIST=repo
32. POM_DEVELOPER_ID=github_username
33. POM_DEVELOPER_NAME=GitHub FullName

增加 README.md 文件，向其他开发者介绍你的开发库以及如何使用它。如果你想在你的 README.md 文件中增加些截图，我极力推荐一款叫做的app。 

安装 GPG

如果你的机器上还没安装 GPG，你需要下载安装它。如果你是 MacOSX 系统，在这里。

如果你从未使用过 GPG – 首先，请创建 GPG 密钥：

1. $ gpg --gen-key

接下来，找到你的密钥 ID：在你创建 GPG 密钥的时候，如果你不确定该如何回答问题， 这篇指南（）可以帮上忙。

1. $ gpg --list-keys

现在，发布你的密钥：第一行像是 pub XXXXX/YYYYYYYY <日期>的。切记，’YYYYYYYY’ 部分，就是你的密钥 ID。

1. $ gpg --keyserver hkp://keyserver.ubuntu.com --send-keys YYYYYYYY
2. $ gpg --keyserver hkp://pgp.mit.edu --send-keys YYYYYYYY

你当然也可以使用其他密钥服务器，你也可以通过如下命令确认你的密钥是否已经发布：

1. $ gpg --keyserver hkp://pgp.mit.edu --search-keys johndoe@example.com # 使用你的邮箱

为了使你的开发库在 网站上列出（也为了其他人方便的引用你的开发库），请上传你的项目到 。 最简单的上传项目的方法是使用 。

Sonatype

1. 在 创建一个 JIRA 帐号。
2. 登录成功后，创建一个 。

我为我的  项目创建了一个  仓库。所以我在 new issue 上填写的字段大概如此：

Group Id : com.github.<github_username>

Project URL : https://github.com/<github_username>/<project_name>

SCM url : https://github.com/<github_username>/<project_name>.git

Username : <sonatype_username>

Already Synced to Central : No

注意：我在你需要填写的字段上增加了括号作为占位符。你需要将它们替换成合适的值。

当你准备提交 issue 的时候，issue 的细节应该要和上面的截图差不多。当你提交完成后，Sonatype 将用 2 个工作日来处理你的 issue。接着，你将收到一份确认邮件，告知你的配置已经准备好了，你可以发布你的开源库了。

不要部署你的开源库，直到你接收到一封表明你的票据已经 OK 了的邮件。 对新项目来说，一个通病就是过早的部署。这将会误使你的构件（artifacts）变成一个人人都能获得的仓库。

最后，如果你的组件已经在中央仓库中了，请在你的票据中添加以下信息，并参考这篇文章，。

修改你本机上的 ~/.gradle/gradle.properties 文件，包含以下内容：

1. NEXUS_USERNAME=sonatype_username
2. NEXUS_PASSWORD=sonatype_password
3. signing.keyId=gpg_key_id
4. signing.password=gpg_password
5. signing.secretKeyRingFile=/Users/username/.gnupg/secring.gpg
6. org.gradle.daemon=true

当你发布开发库的时候，身份认证信息已经在 gradle.properties 文件中提供了。请确保提供了正确的 nexus 用户名和密码（也就是 Sonatype 的用户名和密码），否则你将得到。

注意：如果你之前已经发布过一个开发库，那么你不需要在 JIRA（Sonatype） 上创建一个新的 issue。每个顶级的 groupId 对应一个 JIRA issue。你应该已经有了部署任何新构件到你的 groupId 或者下属 group 应需要的所有权限。中央仓库的同步操作遵循从上到下的过程，所以任何下属组的发布版本都将会自动同步。当你发布新组件，你不需要告诉 Sonatype，因为当你进行仓库同步工作的时候，没有什么需要 Sonatype 去配置或者检查的， Sonatype 仅仅会在第一次进行同步操作的时候，发布一条 twitter。

发布

一旦你准备发布你的开发库，在 Android Studio 中， 打开右侧的 Gradle 视图，在 Tasks> upload 下，点击 uploadArchives，将会上传你的开发库到 。

在  网页上，登陆你的 Sonatype 账号，查找你的 “staging” 开发库，它应该在列表的最后，选中它，并按下 “关闭” 按钮。关闭一个开发库实际上意味着你准备发布它。如果关闭操作一切顺利 – 你应该会看到一个激活了的 ‘发布’ 按钮。你可能需要刷新下页面。请按下发布按钮。请阅读关于的帮助文档。如果这是你发布的第一个开发库，返回到 JIRA，在 JIRA 上发表一条你已经改进了你的开发库的评论，如果不是第一个，就没必要告诉 Sonatype 你改进了你的开发库。然后，你应该会收到来自 Sonatype 的一条回复信息，信息上说你的开发库在 10 分钟内能准备好，将会在接下来的几个小时同步到 Maven 中央仓库。几个小时之后，它将展示在  网站上。

原文发布时间为：2016-05-28

本文来自云栖社区合作伙伴“Linux中国”