GoogleServices之GooglePlayService官方文檔翻譯

 GoogleServices之GooglePlayService官方文檔翻譯

在更普遍的設備上給你的應用程序更多的特性去吸引用戶，使用GooglePlayService,你的應用程序能利用最新的優點，谷歌驅動特性好比地圖，Googl+和更多，使用自動分佈式更新平臺經過GooglePlay商店更新APK. 這使他更快的爲你的用戶接收更新和更容易的爲你集成谷歌提供的最新的。

Google Technology（谷歌科技）

Google play services 爲你提供輕鬆訪問谷歌服務，與安卓系統緊密集成。每一個服務提供了易於使用的客戶端庫,讓你實現你想要的功能更容易、更快捷

Standard Authorization （標準受權）

全部產品在googleplayservices共享一個公共受權API,利用現有的谷歌帳戶受權到設備上。你和你的用戶有一個一致的和安全的方式給予和接收OAuth2谷歌服務訪問令牌

Automatic Updates （自動更新）

設備運行安卓2.3或更高版本的googleplaystore,應用程序將自動接收更新谷歌服務。提升你的應用程序的最新版本的谷歌服務,而不用擔憂你的用戶的Android版本

爲了開始集成googleplayservice在你的應用中，請遵循如下安裝指南：

爲了使用googleplayservices APIS 開發應用，你須要在你的項目中設置googleplayservices SDK。

若是你尚未安裝googleplayservice SDK，去按照如下指南獲取 Adding SDK Packages.

當你使用googleplayservice SDK測試你的應用時，必須使用如下：

1,一個兼容安卓幷包含googleplaystore的設備，運行在2.3或更高版本。

2，安卓虛擬設備的模擬器須要運行google APIS 平臺而且基於安卓4.2.2或更高。

 Add Google Play Services to Your Project

在你的項目中添加googleplayservices   使用工具：eclipse+ADT

使googleplayservice可用於您的應用中：

1,在<android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/這個路徑下複製庫項目到你本地維護的安卓應用項目。

2，導入庫項目在你的eclipse工做空間，Click File > Import, select Android > Existing Android Code into Workspace,瀏覽你拷貝的庫項目並導入他。

3，在你的項目中，參考googleplayservices庫項目，請看：Referencing a Library Project for Eclipse獲取更多如何使用的信息。

注意：你應該參考你複製到你開發工做空間的庫，而不是直接參考AndroidSDK目錄中的。

4,接下來你應該爲你的應用添加googleplayservice庫的倚賴關係，打開你應用的manifest文件並按照下面標籤添加到<application>節點中：

<meta-data android:name="com.google.android.gms.version"
        android:value="@integer/google_play_services_version" />

一旦你設置你的項目參考庫項目，有就能夠使用googleplayservice開發了。

 

Create a Proguard Exception （建立一個異常混淆器）

爲了防止混淆器從必要的類剝離，請在<project_directory>/proguard-project.txt 文件中添加一下行：

-keep class * extends java.util.ListResourceBundle {
     protected Object[][] getContents();
 }
 
 -keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
     public static final *** NULL;
 }
 
 -keepnames @com.google.android.gms.common.annotation.KeepName class *
 -keepclassmembernames class * {
     @com.google.android.gms.common.annotation.KeepName *;
 }
 
 -keepnames class * implements android.os.Parcelable {
     public static final ** CREATOR;
 }

注意：當你使用的是AndroidStudio，你必須添加混淆器在你的build,gradle中，獲取更多信息，請看：Gradle Plugin User Guide.

Ensure Devices Have the Google Play services APK

確保設備有GooglePlayService APK。

按照GooglePlayServices的介紹，googleplay爲在2.3或更高版本的用戶經過googlplaystore應用提供服務更新，而後，更新獲取不能當即達到每一個用戶，因此你的應用在驗證有效版本以前嘗試實行API事務。

重點：由於很難預測每一個設備的狀態，你必須在你訪問googleplayservice以前應該常常檢查googlplayservice的兼容性。對於衆多的應用，最佳的檢測時間是在主activity的onResume方法中。

Google Play services庫包含的實用方法幫助你肯定設備上的Google Play services的版本是否支持你所使用的客戶端庫版本。若是設備上的版本太老，系統將讓用戶更新到最新的Google Play services版本。

  因爲每一個應用使用的Google Play services不盡相同，由你決定在你應用的適當位置來驗證Google Play services的版本。好比：若是Google Play services在你的應用中時刻須要，你可能想在應用第一次加載的時候去作。另外一方面，若是Google Play services是你應用中可選的一部分，你只須要僅僅在你的應用的用戶導航時去驗證版本。

 

  爲了驗證Google Play services版本，調用isGooglePlayServicesAvailable()。若是結果碼是 SUCCESS, 那麼 Google Play services APK是最新的，你能夠繼續鏈接。而後，結果碼是SERVICE_MISSING, SERVICE_VERSION_UPDATE_REQUIRED, or SERVICE_DISABLED,那麼用戶須要安裝更新，因此，調用GooglePlayServicesUtil.getErrorDialog()無論他的錯誤碼。他將會返回一個能展示的對話框，它提供了一個適當的消息和一個action讓用戶去Google Play Store to安裝更新。

下來開始鏈接到Google Play services（像GoogleDriver,Google+和Games同樣須要更多的Google APIS）,閱讀訪問 Google APIS