優(yōu)點

• 上傳APK文件到Google Play

  • 這包括使用多個APK支持的應用程序

• 上傳APK擴展（.obb）文件

  • 從現有的應用程序中選擇與使用擴展文件，例如補丁發(fā)布

• 安排應用程序的alpha、beta或產品發(fā)布

  • 這包括將現有的應用程序移動到不同軌道的構建步驟

  • 例如，你可以在一份工作上傳一個alpha，然后后來又另一個工作推動它到beta

• 生產應用程序的分級部署

• 為各種語言分發(fā)發(fā)布說明到上傳的文件

• 如果由于某些原因配置不好，或上傳應用程序失敗，改變構建結果

• 每一個配置段都支持變量擴展，允許動態(tài)生成的發(fā)布說明

• 結合Google OAuth Plugin，所以憑證可以一次性地進入全局和工作之間的共享

  • 很多Google Play賬號也是通過這一機制支持

計劃即將到來的特點

• 為應用程序上傳截圖和文本

需要

Jenkins

版本1.565.1或以上。

Google Play發(fā)布賬號

僅為了初始設置，你必須能夠登入擁有Google Play發(fā)布賬號的谷歌帳戶。

注意：僅有管理員權限是不夠的；你必須是帳戶的所有者。

你可以在Google Play開發(fā)者控制臺是通過 Settings → User accounts & rights查看帳戶的所有者是誰。

請注意

• 任何上傳的APK將由Google Play立即發(fā)布；它們不會處在遴選或掛起狀態(tài)

• 上傳的應用程序必須已經在Google Play中存在；你不能使用API上傳新的應用程序

• 盡管你只是上傳alpha 或 beta版本的應用程序，你仍然需要為Jenkins提供 Manage Production APKs 許可

  • Google Play API團隊具有“指出這種型號（2014年8月）和仍在研究最安全和最有效的方式以解決使用API接入問題”（自2015年4月開始）

啟動

以前的：設立Google Play憑據

下面的這個視頻顯示了初始安裝過程： https://www.youtube.com/watch?v=txdPSJF94RM

安裝插件

通過Jenkins插件管理器安裝這個插件。

如果進行手動安裝，確保 Google OAuth Plugin及其依賴項已經安裝。

創(chuàng)建谷歌服務帳戶

為了使自動訪問你的Google Play帳戶，你必須創(chuàng)建一個服務帳戶：

1、作為所有者登錄到Google Play開發(fā)者控制臺

2、選擇設置→API訪問

3、點擊“創(chuàng)建新的項目”

4、建立新項目后，點擊“創(chuàng)建服務帳戶”

5、鏈接到谷歌開發(fā)者控制臺

6、創(chuàng)建一個新的OAuth客戶端ID

7、選擇服務帳戶類型

8、要注意到一個.p12文件已經下載，可能會命名為“Google Play Android Developer-xxxxxxxxxxxx.p12”

9、復制創(chuàng)建服務帳戶的電子郵件地址

服務帳戶權限分配

1、返回Google Play開發(fā)者控制臺頁面

2、在對話框上點擊 “完成”

3、請注意，服務帳戶與Google Play發(fā)行帳戶關聯(lián)

4、單擊帳戶的“授予訪問權限”按鈕

5、至少確保下列權限啟用：

• 編輯存儲列表、定價和分銷

• 管理制作的APK

• 管理Alpha和Beta APK

• 管理Alpha 和Beta用戶

6、點擊“添加用戶”

7、現在你可以登錄Google Play發(fā)行帳戶了

添加服務賬號到Jenkins：

1、導航到你的Jenkins實例

2、從Jenkins的側邊欄選擇“證書”

3、選擇一個證書域并點擊“添加證書”

4、從“類”下拉列表，選擇“谷歌服務帳戶密鑰”

5、輸入證書名稱——實際值是不重要的

6、選擇“P12密鑰”類型

7、上傳由谷歌開發(fā)者控制臺下載的.p12文件

8、點擊“OK”創(chuàng)建證書

為了將應用程序發(fā)布到Google Play，Jenkins需要證書和權限。

Per-job config

上傳一個APK

以下設置過程在這個視頻中演示：https://www.youtube.com/watch?v=iu-bLY9-jkc

1、創(chuàng)建一個新的自由形式的軟件項目

2、通過你的需求建立步驟，確保你想上傳的這個APK在建立的工作空間是可用的

3、編譯后添加“上傳的Android APK到Google Play”

4、從下拉列表中選擇證書名稱

• 證書必須屬于擁有應用程序上傳權限的Google Play賬戶

• 5、輸入路徑和/或通配符指向上傳的APK或多個APK

• 這可能是一個Ant式的*/-release.apk，或者一個相對于工作空間根的逗號分隔的文件名列表

6、選擇跟蹤到應當配置的APK

• 如果你使用Jenkins配置作品的發(fā)布，你可以選擇推出的百分比

7、選擇“添加語言”到將發(fā)布的說明以及上傳的APK

• 你可以根據需要添加或多或少的你支持的語言，但是每一種語言都必須已經添加到你的應用程序中，位于Google Play開發(fā)者控制臺的“商店列表”下。

APK擴展文件

你可以選擇為上傳的每個APK增加兩個擴展文件。

擴展文件列表可以以與的應用程序相同的方式指定，但注意，它們必須以[main|patch]...obb.格式命名。你可以從在線幫助獲取更多細節(jié)。

移動現有的APK到另一個版本的軌道

如果你已經上傳一個應用程序到alpha軌道（例如），你可以在以后使用Jenkins重新分配該版本為beta版或產品發(fā)布軌道。

根據工作配置的“構建”章節(jié)，增加了“移動AndroidAPK到不同發(fā)布軌道”的設置步驟，和配置新的發(fā)布軌道。

你可以通過告訴Jenkins 哪一個APK需要移動或直接輸入APK版本代碼，或通過提供APK文件，該插件會為你讀取申請ID和版本代碼。

想要的反饋

如果你是擴展文件的用戶，特別是如果你使用多個APK情況下，這將有助于了解你如何正常地使用擴展文件，且無論什么樣的插件都提供了足夠的信息。 你通常會為每個應用程序的擴展做獨立的主/補丁文件嗎？或者它是更常見的所有APK共享相同的擴展文件嗎？

目前來說，當試圖從現有的應用程序中重新利用擴展文件時（沒有明確地指定那些來自于舊APK的擴展文件需要與新上傳的APK一同重新使用），前者的情況下是不合適的。

通過在頁面頂部的電子郵件告訴我們！

疑難解答

來自于插件的錯誤信息（其中許多都直接來自于Google Play API）應當一目了然。

如果你獲得特定配置工作中遇到了麻煩，請嘗試手動上傳相同的APK到Google Play。這樣你可能就會看到失敗的原因，例如版本代碼沖突或類似。

或者，請給我們發(fā)送錯誤報告或包含有相信信息的郵件，包括構建控制臺日志輸出；在頁面頂部的信息框內查看我們的聯(lián)系信息。

常見問題

如果我想上傳多個、不同應用ID的APK程序（即構建風格），該怎么辦？

使用Android Gradle構建系統(tǒng)的構建風格特點，它可能是有一個單一Android構建產生多個APK，每一個APK有一個不同的應用ID。

例如，你可以有應用程序ID“com.example.app”和“com.example.app.pro”分別為免費和付費版本。

這些往往是建立在一個單一的Jenkins的工作中，有人想知道為什么這個插件將拒絕上傳的在一個單一的工作中具有不同應用ID的APK。

然而，就Google Play所考慮的方面而言，這些都是完全獨立的應用程序。這是正確的，因此應該在單獨的Jenkins構建（每一個應用ID）上傳。

如果您想嘗試在一個Jenkins構建中上傳完全不同的APK（比如三個），這就需要用Google Play API開放和提交三個獨立的“編輯會話”。如果其中任何一個失敗——也許是因為一個無效的APK，或由于一個API失敗（不幸的是，使用Google Play API過程中這種情況并不少見）——你將使你的Google Play帳戶處于不一致的狀態(tài)而結束。您的構建將被標記為失敗，但有一個或多個應用程序實際上已經上傳并發(fā)布到Google Play，所以你就必須手動修復這種情況。此外，你將不能僅進行重新運行構建，因為這將由于已經存在的APK而失敗。

在這種情況下的最佳方法是有一項工作構建不同的風格（即APK使用不同的應用程序ID），然后，如果構建成功，這將存檔的APK和啟動多個“下游”Jenkins構建，這將單獨發(fā)布的每個應用程序。

即“上傳”的工作可能是通用的，可以通過參數接收APK的信息。

待辦事項： 提供更多關于如何設置的信息。