From a79acc0315d33080527b9fb48ba063fb4104de37 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Fri, 14 Nov 2014 19:19:18 -0800 Subject: [PATCH] Doc change: localized content. Change-Id: I5440fe8d6003bdd8e3cb4c44bacea422f322c33b --- .../intl/zh-cn/about/versions/android-5.0.jd | 633 +++++++++++ .../intl/zh-cn/about/versions/lollipop.jd | 259 +++++ .../intl/zh-cn/design/style/writing.jd | 311 ++++++ .../intl/zh-cn/distribute/essentials/index.jd | 34 + .../distribute/essentials/quality/core.jd | 998 ++++++++++++++++++ .../distribute/essentials/quality/tablets.jd | 582 ++++++++++ .../intl/zh-cn/distribute/resources.jd | 56 + .../intl/zh-cn/distribute/tools/index.jd | 56 + .../distribute/tools/launch-checklist.jd | 709 +++++++++++++ .../tools/localization-checklist.jd | 698 ++++++++++++ .../zh-cn/distribute/tools/promote/badges.jd | 278 +++++ .../zh-cn/distribute/tools/promote/brand.jd | 148 +++ .../distribute/tools/promote/device-art.jd | 675 ++++++++++++ .../zh-cn/distribute/tools/promote/linking.jd | 186 ++++ .../intl/zh-cn/google/play/billing/api.jd | 117 ++ .../google/play/billing/billing_admin.jd | 364 +++++++ .../play/billing/billing_best_practices.jd | 81 ++ .../google/play/billing/billing_overview.jd | 93 ++ .../google/play/billing/billing_testing.jd | 190 ++++ .../intl/zh-cn/google/play/billing/index.jd | 47 + docs/html-intl/intl/zh-cn/index.jd | 107 ++ docs/html-intl/intl/zh-cn/resources.jd | 57 + .../intl/zh-cn/tools/help/proguard.jd | 133 +++ .../intl/zh-cn/tools/publishing/preparing.jd | 186 ++++ .../tools/publishing/publishing_overview.jd | 142 +++ .../training/basics/fragments/fragment-ui.jd | 139 +++ .../training/monitoring-device-state/index.jd | 2 +- .../intl/zh-cn/training/multiscreen/index.jd | 2 +- docs/html/design/design_toc.cs | 2 +- .../distribute/essentials/essentials_toc.cs | 4 +- docs/html/distribute/tools/disttools_toc.cs | 12 +- docs/html/google/google_toc.cs | 12 +- docs/html/jd_collections.js | 305 +++++- docs/html/jd_extras.js | 232 +++- docs/html/resources.jd | 52 + docs/html/tools/tools_toc.cs | 6 +- docs/html/training/training_toc.cs | 2 +- 37 files changed, 7883 insertions(+), 27 deletions(-) create mode 100644 docs/html-intl/intl/zh-cn/about/versions/android-5.0.jd create mode 100644 docs/html-intl/intl/zh-cn/about/versions/lollipop.jd create mode 100644 docs/html-intl/intl/zh-cn/design/style/writing.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/essentials/index.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/essentials/quality/core.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/essentials/quality/tablets.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/resources.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/index.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/launch-checklist.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/localization-checklist.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/promote/badges.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/promote/brand.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/promote/device-art.jd create mode 100644 docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd create mode 100644 docs/html-intl/intl/zh-cn/google/play/billing/api.jd create mode 100644 docs/html-intl/intl/zh-cn/google/play/billing/billing_admin.jd create mode 100644 docs/html-intl/intl/zh-cn/google/play/billing/billing_best_practices.jd create mode 100644 docs/html-intl/intl/zh-cn/google/play/billing/billing_overview.jd create mode 100644 docs/html-intl/intl/zh-cn/google/play/billing/billing_testing.jd create mode 100644 docs/html-intl/intl/zh-cn/google/play/billing/index.jd create mode 100644 docs/html-intl/intl/zh-cn/index.jd create mode 100644 docs/html-intl/intl/zh-cn/resources.jd create mode 100644 docs/html-intl/intl/zh-cn/tools/help/proguard.jd create mode 100644 docs/html-intl/intl/zh-cn/tools/publishing/preparing.jd create mode 100644 docs/html-intl/intl/zh-cn/tools/publishing/publishing_overview.jd create mode 100644 docs/html-intl/intl/zh-cn/training/basics/fragments/fragment-ui.jd create mode 100644 docs/html/resources.jd diff --git a/docs/html-intl/intl/zh-cn/about/versions/android-5.0.jd b/docs/html-intl/intl/zh-cn/about/versions/android-5.0.jd new file mode 100644 index 0000000000000..b4ce5602e2ad3 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/about/versions/android-5.0.jd @@ -0,0 +1,633 @@ +page.title=Android 5.0 API +excludeFromSuggestions=true +sdk.platform.version=5.0 +sdk.platform.apiLevel=21 +@jd:body + + +
+
+ +

このドキュメントの内容 詳細を表示

+ +
    +
  1. 対象 API レベルの更新
    2. +
  2. 動作に関する重要な変更 +
      +
    1. まだ新しい Android Runtime（ART）に対してアプリをテストしていない場合
      2. +
    2. アプリで通知を実装する場合
      3. +
    3. アプリで RemoteControlClient を使用する場合
      4. +
    4. アプリで getRecentTasks() を使用する場合
      5. +
    5. Android Native Development Kit（NDK）を使用している場合
      6. +
    6. アプリからサービスにバインドする場合
      7. +
    7. アプリで WebView を使用する場合
      8. +
    +
    3. +
  3. ユーザー インターフェース +
      +
    1. Material Design のサポート
      2. +
    2. 最近使ったアプリ画面に表示される同時実行中のドキュメント / アクティビティ
      3. +
    3. WebView の更新
      4. +
    4. 画面のキャプチャと共有
      5. +
    +
    4. +
  4. 通知 +
      +
    1. ロック画面の通知
      2. +
    2. 通知メタデータ
      3. +
    +
    5. +
  5. グラフィック +
      +
    1. OpenGL ES 3.1 のサポート
      2. +
    2. Android Extension Pack
      3. +
    +
    6. +
  6. メディア +
      +
    1. 高度なカメラ機能に対応した Camera API
      2. +
    2. 音声の再生
      3. +
    3. メディア再生コントロール
      4. +
    4. メディアの参照
      5. +
    +
    7. +
  7. ストレージ +
      +
    1. ディレクトリの選択
      2. +
    +
    8. +
  8. ワイヤレスと接続 +
      +
    1. マルチネットワーク接続
      2. +
    2. Bluetooth によるブロードキャスト
      3. +
    3. NFC の機能強化
      4. +
    +
    9. +
  9. Project Volta +
      +
    1. ジョブのスケジューリング
      2. +
    2. 電池の使用統計情報を提供するデベロッパー向けツール +
    +
    10. +
  10. 職場向けや教育向けの Android +
      +
    1. 管理対象プロビジョニング
      2. +
    2. 端末所有者
      3. +
    3. 画面の固定
      4. +
    +
    11. +
  11. システム +
      +
    1. アプリの使用統計情報
      2. +
    +
    12. +
  12. 印刷フレームワーク +
      +
    1. PDF をビットマップとしてレンダリング
      2. +
    +
    13. +
  13. テストとユーザー補助 +
      +
    1. テストとユーザー補助の向上
      2. +
    +
    14. +
  14. IME +
      +
    1. 入力言語の切り替えやすさの向上
      2. +
    +
    15. +
  15. マニフェスト宣言 +
      +
    1. 宣言可能な必須機能
      2. +
    2. ユーザー権限
      3. +
    +
    16. +
+ +

API の変更内容

+
    +
  1. API レベル: 20 から 21 へ »
    2. +
  2. レベル: デベロッパー プレビューから 21 へ »
    3. +
+ +
+
+ +

API レベル: {@sdkPlatformApiLevel}

+ +

Android 5.0（Lollipop）は、ユーザーとアプリ デベロッパーに新しい機能を提供します。このドキュメントでは、最も重要な新しい API を紹介しています。

+ +

新しいプラットフォーム機能の概要について詳しくは、Android Lollipop の特長をご覧ください。

+ + +

開発の開始

+ +

Android 5.0 対応アプリの開発を始めるには、最初に Android SDK を入手する必要があります。次に、SDK Manager を使用して Android 5.0 SDK プラットフォームとシステム イメージをダウンロードします。

+ +

アプリを実機でテストするには、
Android プレビュー システム イメージを使用して Nexus 5 または Nexus 7 のフラッシュに書き込みます。

+ + + +

対象 API レベルの更新

+ +

Android {@sdkPlatformVersion} 搭載端末向けにアプリの最適化を向上させるには、{@code targetSdkVersion} を "{@sdkPlatformApiLevel}" に設定し、Android {@sdkPlatformVersion} システム イメージにアプリをインストールした後、この変更を加えた更新済みのアプリを公開します。

+ +

Android {@sdkPlatformVersion} API を使用しながら旧バージョンも同時にサポートするには、{@code minSdkVersion} でサポートされていない API を実行する前に、システムの API レベルをチェックする条件をコードに追加します。下位互換性の維持について詳しくは、複数のプラットフォーム バージョンへの対応をご覧ください。

+ +

API レベルの仕組みについて詳しくは、API レベルとはをご覧ください。

+ +

動作に関する重要な変更

+ +

以前に Android 対応アプリを公開したことがある場合は、アプリが Android 5.0 の変更による影響を受ける可能性があることに注意してください。

+ +

まだ新しい Android Runtime（ART）に対してアプリをテストしていない場合

+ +

リリース 4.4 では新しい Android ランタイムである ART が試験的に導入されていました。4.4 では、ART はオプションで、デフォルトのランタイムは Dalvik のままでした。Android 5.0 では、ART がデフォルトのランタイムになりました。

+ +

ART の新機能の概要について詳しくは、ART の紹介をご覧ください。主に次のような新機能があります。

+ + + +

ほとんどの Android アプリは変更を加えなくても ART で問題なく動作します。ただし、Dalvik で動作する一部の技術が ART で動作しません。特に重要な問題について詳しくは、Android Runtime（ART）でアプリの動作を検証するをご覧ください。特に次の点にご注意ください。

+ + + +

アプリで通知を実装する場合

+ +

通知を実装する際は、Android 5.0 での変更点について必ず考慮してください。Android 5.0 以降に対応した通知の設計について詳しくは、通知の設計に関するガイドをご覧ください。 +

+ +

Material Design スタイル

+

通知は、新しい Material Design ウィジェットに合わせて、白色（または非常に明るい色）の背景の上に暗い色のテキストで描かれます。すべての通知が新しい配色で見やすくなるようにしてください。通知が見にくい場合は、次の方法で修正してください。

+ + + +

音声とバイブレーション

+

現在 {@link android.media.Ringtone}、{@link android.media.MediaPlayer}、または {@link android.os.Vibrator} クラスを使用して音声やバイブレーションを通知に追加している場合は、システムが「優先」モードで通知を正しく表示できるように、それらのコードを削除してください。代わりに {@link android.app.Notification.Builder} のメソッドを使用して音声やバイブレーションを追加してください。

+ +

端末を {@link android.media.AudioManager#RINGER_MODE_SILENT RINGER_MODE_SILENT} に設定すると端末が新しい優先モードになります。端末を {@link android.media.AudioManager#RINGER_MODE_NORMAL RINGER_MODE_NORMAL} または {@link android.media.AudioManager#RINGER_MODE_NORMAL RINGER_MODE_VIBRATE} に設定すると端末の優先モードが終了します。

+ +

従来、Android ではタブレット端末のボリュームをコントロールするために {@link android.media.AudioManager#STREAM_MUSIC STREAM_MUSIC} をマスター ストリームとして使用していました。Android 5.0 では、携帯電話とタブレット端末の両方のマスター ボリューム ストリームが統合され、{@link android.media.AudioManager#STREAM_RING STREAM_RING} または {@link android.media.AudioManager#STREAM_NOTIFICATION STREAM_NOTIFICATION} によってコントロールされるようになりました。

+ +

ロック画面の表示

+

Android 5.0 ではデフォルトでユーザーのロック画面に通知が表示されるようになりました。ユーザーは機密情報の表示を防ぐことを選択できます。その場合は通知に表示されるテキストが自動的に編集されます。編集される通知をカスタマイズする場合は、{@link android.app.Notification.Builder#setPublicVersion(android.app.Notification) setPublicVersion()} を使用してください。

+

通知に個人情報が含まれていない場合や、通知にメディア再生コントロールを表示できるようにしたい場合は、{@link android.app.Notification.Builder#setVisibility(int) setVisibility()} メソッドを呼び出して通知の表示レベルを {@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC} に設定してください。 +

+ +

メディアの再生

+

メディアの再生状態やトランスポート コントロールを表示する通知を実装する場合は、カスタムの {@link android.widget.RemoteViews.RemoteView} オブジェクトに代わって新しい {@link android.app.Notification.MediaStyle} テンプレートを使用することをおすすめします。どちらのアプローチの場合でも、必ず通知の表示を {@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC} に設定して、ロック画面からコントロールにアクセスできるようにしてください。Android 5.0 以降では、ロック画面に {@link android.media.RemoteControlClient} オブジェクトが表示されなくなりました。詳しくは、アプリで RemoteControlClient を使用する場合をご覧ください。

+ +

警告通知

+

必要に応じて、端末がアクティブのとき（端末のロックが解除されていて画面が表示されているとき）に通知が小さいフローティング ウィンドウ（警告通知ともいいます）に表示されるようになりました。これらの通知の外観はデベロッパーによる簡易形式の通知に似ていますが、警告通知には操作ボタンも表示されます。ユーザーは、現在のアプリから離れることなく警告通知に応答したり、警告通知を拒否したりできます。

+ +

たとえば次のような条件の場合に警告通知が起動されることがあります。

+ + + +

こうした条件の下でアプリで通知を実装する場合は、必ず警告通知が正しく表示されるようにしてください。

+ +

アプリで RemoteControlClient を使用する場合

+

{@link android.media.RemoteControlClient} クラスは非推奨になりました。できるだけ速やかに新しい {@link android.media.session.MediaSession} API に切り替えてください。

+ +

Android 5.0 のロック画面には {@link android.media.session.MediaSession} または {@link android.media.RemoteControlClient} に対応したトランスポート コントロールは表示されません。アプリでは代わりに、通知を通してロック画面からメディア再生コントロールを提供することができます。これにより、メディアボタンの表示をより詳細にコントロールできるようになると同時に、端末のロック時とロック解除時で一貫したユーザー エクスペリエンスが提供されます。

+ +

この目的のために、Android 5.0 では新しい {@link android.app.Notification.MediaStyle} テンプレートが導入されています。{@link android.app.Notification.MediaStyle} は、{@link android.app.Notification.Builder#addAction(int, java.lang.CharSequence, android.app.PendingIntent) Notification.Builder.addAction()} で追加した通知操作をコンパクトなボタンに変換し、アプリのメディア再生通知に埋め込みます。セッション トークンを {@link android.app.Notification.MediaStyle#setMediaSession(android.media.session.MediaSession.Token) setSession()} メソッドに渡し、この通知によって以後のメディア セッションがコントロールされることをシステムに伝えます。

+ +

必ず通知の表示を {@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC} に設定し、どのようなロック画面でも安全に表示できる（それ以外の場合はセキュリティで保護される）ものとしてマークします。詳しくは、ロック画面の通知をご覧ください。

+ +

アプリを Android TV または Wear プラットフォームで実行する場合、メディア再生コントロールを表示するには {@link android.media.session.MediaSession} クラスを実装してください。アプリで Android 端末のメディアボタン イベントを受信する必要がある場合は、{@link android.media.session.MediaSession} も実装してください。

+ +

アプリで getRecentTasks() を使用する場合

+ +

Android 5.0 で新しい「同時実行中のドキュメント / アクティビティ タスク」機能が導入されたことに伴い（下記の最近使ったアプリ画面に表示される同時実行中のドキュメント / アクティビティをご覧ください）、ユーザーのプライバシーを向上させるために {@link android.app.ActivityManager#getRecentTasks ActivityManager.getRecentTasks()} メソッドは非推奨になりました。下位互換性の目的から、このメソッドは引き続きデータの小さなサブセット（呼び出し側アプリの独自のタスクや、他の機密でないタスク（たとえばホーム）など）を返します。アプリで独自のタスクを取得するためにこのメソッドを使用している場合は、代わりに {@link android.app.ActivityManager#getAppTasks() getAppTasks()} を使用してその情報を取得してください。

+ +

Android Native Development Kit（NDK）を使用している場合

+ +

Android 5.0 では 64 ビット システムのサポートが導入されています。64 ビットへの拡大によってアドレス空間が増加し、パフォーマンスが向上します。一方で、既存の 32 ビット アプリについても引き続き完全にサポートされます。また、64 ビットのサポートによって OpenSSL の暗号化のパフォーマンスも向上します。さらに、今回のリリースではネイティブの OpenGL ES（GLES）3.1 のサポートに加えて、新しいネイティブのメディア NDK API も導入されています。

+ +

Android 5.0 で提供される 64 ビットのサポートを利用するには、Android NDK のページから NDK Revision 10c をダウンロードしてインストールしてください。NDK の重要な変更点とバグ修正について詳しくは、Revision 10c のリリースノートをご覧ください。

+ +

アプリからサービスにバインドする場合

+ +

{@link android.content.Context#bindService(android.content.Intent, android.content.ServiceConnection, int) Context.bindService()} メソッドについて、明示的な {@link android.content.Intent} の指定が必須となり、暗黙的なインテントを指定した場合は例外をスローするようになりました。アプリが確実にセキュリティで保護されるように、{@link android.app.Service} の起動やバインドの際は明示的なインテントを使用し、サービスに対してインテント フィルタを宣言しないでください。

+ +

アプリが WebView を使用している場合

+ +

Android 5.0 ではアプリのデフォルトの動作が変更されています。

+ + +

ユーザー インターフェース

+ +

Material Design のサポート

+ +

次期リリースでは、Android の新しい「Material Design」スタイルが新たにサポートされます。Material Design を使うと、外観が動的に変化し、ユーザーが UI 要素の切り替えを自然だと感じるようなアプリを作成できます。このサポートには以下が含まれます。

+ + + +

アプリに Material Design の機能を追加する方法について詳しくは、Material Design をご覧ください。

+ +

最近使ったアプリ画面に表示される同時実行中のドキュメント / アクティビティ

+ +

以前のリリースでは、最近使ったアプリ画面には、ユーザーが最近操作したアプリごとにタスクを 1 つずつしか表示できませんでした。今後は、ドキュメント用の同時実行中のアクティビティが追加される場合、必要に応じて複数のタスクをアプリで開けるようになります。この機能により、ユーザーは最近使ったアプリ画面から個々のアクティビティやドキュメントをすばやく切り替えられるようになります。すべてのアプリにわたって一貫した切り替え操作になるので、マルチタスクの操作がしやすくなります。こうした同時実行中のタスクの例としては、ウェブブラウザ アプリで複数のタブを開く、生産性向上アプリで複数のドキュメントを開く、ゲームで複数の試合を同時に実行する、メッセージ アプリで複数のチャットを実行する、などが考えられます。アプリのタスクは {@link android.app.ActivityManager.AppTask} クラスを使って管理できます。

+ +

論理的な切れ目を挿入してアクティビティが新しいタスクとして扱われるようにするには、{@link android.app.Activity#startActivity(android.content.Intent) startActivity()} を使用してアクティビティを起動するときに {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} を使用します。または、マニフェストで <activity> 要素の {@code documentLaunchMode} 属性を {@code "intoExisting"} または {@code "always"} に設定しても、この動作を実現できます。

+ +

最近使ったアプリ画面が適切に整理されるように、最近使ったアプリ画面に表示できるタスクの最大数をアプリから設定することができます。それには、<application> 属性 {@link android.R.attr#maxRecents android:maxRecents} を設定します。指定できる現在の最大タスク数はユーザーあたり 50 個（RAM が不足している端末の場合は 25 個）です。

+ +

最近使ったアプリ画面に表示されるタスクが再起動後も持続されるように設定することができます。この持続動作をコントロールするには android:persistableMode 属性を使用します。また、{@link android.app.Activity#setTaskDescription(android.app.ActivityManager.TaskDescription) setTaskDescription()} メソッドを呼び出して、最近使ったアプリ画面に表示されるアクティビティの表示プロパティ（アクティビティの色、ラベル、アイコンなど）を変更することもできます。

+ +

WebView の更新

+

Android 5.0 では Chromium M37 に対する {@link android.webkit.WebView} の実装が更新され、セキュリティと安定性が強化されているほか、バグが修正されています。Android 5.0 で実行される {@link android.webkit.WebView} のデフォルトのユーザーエージェント文字列が更新され、バージョン番号として 37.0.0.0 が組み込まれています。

+ +

今回のリリースでは {@link android.webkit.PermissionRequest} クラスが導入されています。アプリでこのクラスを使用することで、getUserMedia() などのウェブ API を通じてカメラやマイクなどの保護リソースにアクセスするための権限を {@link android.webkit.WebView} に許可できます。{@link android.webkit.WebView} に権限を許可するためには、これらのリソースに対する適切な Android 権限をアプリに持たせる必要があります。

+ +

新しい onShowFileChooser() メソッドでは、{@link android.webkit.WebView} で入力フォーム項目を使用できるようになり、ファイル選択機能を起動して Android 端末から画像やファイルを選択できるようになりました。

+ +

さらに、今回のリリースでは WebAudio、WebGL、WebRTC の各オープン規格もサポートされるようになります。今回のリリースに含まれる新機能について詳しくは、Android 用 WebView をご覧ください。

+ +

画面のキャプチャと共有

+

Android 5.0 では、新しい {@link android.media.projection} API を使用して画面キャプチャ機能や画面共有機能をアプリに追加できます。この機能は、たとえばビデオ会議アプリで画面の共有を有効にしたい場合などに便利です。

+ +

アプリで新しい {@link android.media.projection.MediaProjection#createVirtualDisplay(java.lang.String, int, int, int, int, android.view.Surface, android.hardware.display.VirtualDisplay.Callback, android.os.Handler) createVirtualDisplay()} メソッドを使用すると、メイン画面（デフォルトの表示）の内容をキャプチャして {@link android.view.Surface} オブジェクトに取り込み、アプリからネットワーク経由で送信することができます。API では、セキュリティで保護されていない画面内容のキャプチャのみ可能であり、システム音声のキャプチャはできません。アプリで画面のキャプチャを開始するには、最初に {@link android.media.projection.MediaProjectionManager#createScreenCaptureIntent()} メソッドを通じて取得した {@link android.content.Intent} を使用して画面キャプチャ用のダイアログを起動し、ユーザーの許可をリクエストする必要があります。

+ +

新しい API の使用例については、サンプル プロジェクトの {@code MediaProjectionDemo} クラスをご覧ください。

+ +

通知

+ +

ロック画面の通知

+

Android 5.0 のロック画面には通知を表示する機能が組み込まれています。ユーザーは [設定] を通じて、機密性のある通知内容をセキュリティで保護されたロック画面に表示できるようにするかどうかを選択できます。

+ +

アプリでは、セキュリティで保護されたロック画面にアプリの通知が表示されるときの表示の詳細レベルをコントロールできます。表示レベルをコントロールするには、{@link android.app.Notification.Builder#setVisibility(int) setVisibility()} を呼び出して次のいずれかの値を指定します。

+ + + +

表示レベルが {@link android.app.Notification#VISIBILITY_PRIVATE VISIBILITY_PRIVATE} の場合は、詳細な個人情報を隠した編集済みの通知内容を表示することもできます。たとえば SMS アプリで、「3 個の新しいテキスト メッセージがあります」という通知は表示しますが、メッセージの内容や送信者を表示しないようにできます。こうした代わりの通知を表示するには、最初に {@link android.app.Notification.Builder} を使用して代わりとなる通知を作成します。プライベートの通知オブジェクトを作成するときに、{@link android.app.Notification.Builder#setPublicVersion(android.app.Notification) setPublicVersion()} メソッドを使用して代わりの通知をオブジェクトに添付します。

+ +

通知メタデータ

+

Android 5.0 では、アプリの通知がよりスマートに並べ替えられるように、通知に関連付けられたメタデータが使用されます。メタデータを設定するには、通知の作成時に {@link android.app.Notification.Builder} で次のメソッドを呼び出します。

+ + + +

グラフィック

+ +

OpenGL ES 3.1 のサポート

+

Android 5.0 では、OpenGL ES 3.1 のネイティブ サポートとそれに対応した Java インターフェースが追加されています。OpenGL ES 3.1 では主に次の新機能が提供されています。

+ + + +

Android での OpenGL ES 3.1 の Java インターフェースは {@link android.opengl.GLES31} で提供されます。OpenGL ES 3.1 を使用する場合は、必ずマニフェスト ファイルで {@code } タグと {@code android:glEsVersion} 属性を使用して宣言してください。次に例を示します。

+ +
+<manifest>
+    <uses-feature android:glEsVersion="0x00030001" />
+    ...
+</manifest>
+
+ +

端末でサポートされている OpenGL ES のバージョンを実行時にチェックする方法など、OpenGL ES の使い方について詳しくは、OpenGL ES API ガイドをご覧ください。

+ +

Android Extension Pack

+ +

OpenGL ES 3.1 に加えて、今回のリリースでは、高度なグラフィック機能のネイティブ サポートとそれに対応した Java インターフェースを実現する拡張パックが提供されています。これらの拡張機能は Android で 1 つのパッケージとして扱われます（{@code ANDROID_extension_pack_es31a} 拡張機能が存在する場合、アプリではパッケージ内のすべての拡張機能が存在すると見なして、1 つの {@code #extension} ステートメントでシェーディング言語機能を有効にすることができます）。

+ +

拡張パックは以下をサポートします。

+ + + +

拡張パックの Java インターフェースは {@link android.opengl.GLES31Ext} で提供されます。アプリのマニフェストで、拡張パックをサポートしている端末にのみアプリをインストールする必要があることを宣言できます。次に例を示します。

+ +
+<manifest>
+    <uses-feature android:name=“android.hardware.opengles.aep”
+        android:required="true" />
+    ...
+</manifest>
+
+ +

メディア

+ +

高度なカメラ機能に対応した Camera API

+ +

Android 5.0 では、写真のキャプチャや画像処理をきめ細かく行えるように、新しい android.hardware.camera2 API が導入されています。プログラムから、{@link android.hardware.camera2.CameraManager#getCameraIdList() getCameraIdList()} を通じてシステムで使用できるカメラデバイスにアクセスし、{@link android.hardware.camera2.CameraManager#openCamera(java.lang.String, android.hardware.camera2.CameraDevice.StateCallback, android.os.Handler) openCamera()} を通じて特定のデバイスに接続できるようになりました。画像のキャプチャを開始するには、{@link android.hardware.camera2.CameraCaptureSession} を作成し、キャプチャした画像を送信するための {@link android.view.Surface} オブジェクトを指定します。{@link android.hardware.camera2.CameraCaptureSession} を設定して、1 枚のショットを撮影するようにしたり、一度に複数の画像を撮影するようにしたりできます。

+ +

新しい画像がキャプチャされたときに通知を受けるには、{@link android.hardware.camera2.CameraCaptureSession.CaptureCallback} リスナを実装してキャプチャ リクエストで設定します。画像キャプチャ リクエストが完了すると、{@link android.hardware.camera2.CameraCaptureSession.CaptureCallback} リスナが {@link android.hardware.camera2.CameraCaptureSession.CaptureCallback#onCaptureCompleted(android.hardware.camera2.CameraCaptureSession, android.hardware.camera2.CaptureRequest, android.hardware.camera2.TotalCaptureResult) onCaptureCompleted()} への呼び出しを受信し、{@link android.hardware.camera2.CaptureResult} に画像キャプチャ メタデータが設定されます。

+ +

アプリで {@link android.hardware.camera2.CameraCharacteristics} クラスを使用すると、端末でどのカメラ機能が使用できるのかを検出できます。オブジェクトの {@link android.hardware.camera2.CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL INFO_SUPPORTED_HARDWARE_LEVEL} プロパティは、カメラの機能レベルを表します。

+ + + +

最新の Camera API の使い方について詳しくは、このリリースに付属している {@code Camera2Basic} と {@code Camera2Video} の実装サンプルをご覧ください。

+ +

音声の再生

+

今回のリリースでは {@link android.media.AudioTrack} に次の変更が加えられています。

+ + +

メディア再生コントロール

+

メディアの再生についての情報をシステム UI に知らせ、アルバムアートの抽出と表示ができるように、新しい通知 / メディア API を使用してください。UI とサービスにまたがるメディアの再生のコントロールが、新しい {@link android.media.session.MediaSession} クラスと {@link android.media.session.MediaController} クラスを使用して、より簡単に行えるようになりました。

+ +

新しい {@link android.media.session.MediaSession} クラスは非推奨となった {@link android.media.RemoteControlClient} クラスの代わりとなるもので、トランスポート コントロールとメディアボタンを処理するための単一のコールバック メソッド セットを提供します。アプリでメディアの再生を提供して Android TV または Wear プラットフォームで実行する場合は、{@link android.media.session.MediaSession} クラスを使用し、同じコールバック メソッドを通じてトランスポート コントロールを処理してください。

+ +

新しい {@link android.media.session.MediaController} クラスを使用して独自のメディア コントローラ アプリを作成できるようになりました。このクラスは、アプリの UI プロセスからスレッドセーフな方法でメディアの再生を監視しコントロールするための手段を提供します。コントローラの作成時に {@link android.media.session.MediaSession.Token} オブジェクトを指定し、指定した {@link android.media.session.MediaSession} をアプリから操作できるようにします。{@link android.media.session.MediaController.TransportControls} のメソッドを使用すると、そのセッションで {@link android.media.session.MediaController.TransportControls#play() play()}、{@link android.media.session.MediaController.TransportControls#stop() stop()}、{@link android.media.session.MediaController.TransportControls#skipToNext() skipToNext()}、{@link android.media.session.MediaController.TransportControls#setRating(android.media.Rating) setRating()} などのコマンドを送信してメディアの再生をコントロールできます。また、コントローラで {@link android.media.session.MediaController.Callback} オブジェクトを登録し、そのセッションでメタデータや状態変更がないかをリッスンできます。

+ +

さらに、新しい {@link android.app.Notification.MediaStyle} クラスを使用して、再生コントロールをメディア セッションに結び付けることができる高機能な通知を作成できます。

+ +

メディアの参照

+

Android 5.0 では、新しい android.media.browse API を通じて、あるアプリから別のアプリのメディア コンテンツ ライブラリを参照する機能が導入されています。アプリのメディア コンテンツを公開するには、{@link android.service.media.MediaBrowserService} クラスを拡張します。{@link android.service.media.MediaBrowserService} の実装で {@link android.media.session.MediaSession.Token} へのアクセスを提供することで、別のアプリがそのサービスを通じて提供されるメディア コンテンツを再生できるようになります。

+

メディア ブラウザ サービスを操作するには、{@link android.media.browse.MediaBrowser} クラスを使用します。{@link android.media.browse.MediaBrowser} インスタンスの作成時に、{@link android.media.session.MediaSession} のコンポーネント名を指定します。その後、アプリからブラウザ インスタンスを使用して、関連付けられたサービスに接続し、{@link android.media.session.MediaSession.Token} オブジェクトを取得して、そのサービスを通じて公開されたコンテンツを再生できます。

+ +

ストレージ

+ +

ディレクトリの選択

+ +

Android 5.0 ではストレージ アクセス フレームワークが拡張され、ユーザーがディレクトリのサブツリー全体を選択し、それぞれのアイテムについてユーザーの確認を必要とせずに、含まれているすべてのドキュメントへの読み取り / 書き込みアクセス権をアプリに与えることができるようになります。

+ +

ディレクトリのサブツリーを選択するには、{@link android.content.Intent#ACTION_OPEN_DOCUMENT_TREE OPEN_DOCUMENT_TREE} インテントを作成して送信します。サブツリーの選択をサポートしているすべての {@link android.provider.DocumentsProvider} インスタンスが表示され、ユーザーがディレクトリを参照して選択することができます。返される URI は、選択されたサブツリーへのアクセス手段を表します。その後、{@link android.provider.DocumentsContract#buildChildDocumentsUriUsingTree(android.net.Uri, java.lang.String) buildChildDocumentsUriUsingTree()} と {@link android.provider.DocumentsContract#buildDocumentUriUsingTree(android.net.Uri, java.lang.String) buildDocumentUriUsingTree()} を {@link android.content.ContentResolver#query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String) query()} と一緒に使用することでサブツリーを探索できます。

+ +

新しい {@link android.provider.DocumentsContract#createDocument(android.content.ContentResolver, android.net.Uri, java.lang.String, java.lang.String) createDocument()} メソッドを使用すると、サブツリーの配下に新しいドキュメントやディレクトリを作成できます。既存のドキュメントを管理するには、{@link android.provider.DocumentsContract#renameDocument(android.content.ContentResolver, android.net.Uri, java.lang.String) renameDocument()} と {@link android.provider.DocumentsProvider#deleteDocument(java.lang.String) deleteDocument()} を使用します。これらの呼び出しを実行する前に、{@link android.provider.DocumentsContract.Document#COLUMN_FLAGS COLUMN_FLAGS} をチェックして、提供側が呼び出しをサポートしているかどうかを確認してください。

+ +

{@link android.provider.DocumentsProvider} を実装しようとしていて、サブツリーの選択をサポートしたい場合は、{@link android.provider.DocumentsProvider#isChildDocument(java.lang.String, java.lang.String) isChildDocument()} を実装し、{@link android.provider.DocumentsContract.Root#FLAG_SUPPORTS_IS_CHILD FLAG_SUPPORTS_IS_CHILD} を {@link android.provider.DocumentsContract.Root#COLUMN_FLAGS COLUMN_FLAGS} に追加します。

+ +

Android 5.0 ではまた、共有ストレージ上の新しいパッケージ固有ディレクトリが導入されており、{@link android.provider.MediaStore} に含めることでアプリからメディア ファイルを配置することができます。新しい {@link android.content.Context#getExternalMediaDirs()} は、すべての共有ストレージ デバイスにあるこれらのディレクトリへのパスを返します。{@link android.content.Context#getExternalFilesDir(java.lang.String) getExternalFilesDir()} と同様に、アプリから追加の権限がなくても、返されるパスにアクセスできます。これらのディレクトリはプラットフォームによって定期的にスキャンされ、新しいメディアがないかが調べられますが、{@link android.media.MediaScannerConnection} を使用して明示的にスキャンし、新しいコンテンツがないかを調べることもできます。

+ +

ワイヤレスと接続

+ +

マルチネットワーク接続

+

Android 5.0 では新しいマルチネットワーク API が導入されています。これらの API を通じてアプリで動的にスキャンを実行し、特定の機能を持つネットワークが使用できないかを調べて、それらへの接続を確立することができます。この機能は、アプリで SUPL、MMS、キャリア課金ネットワークなどの特殊なネットワークを必要とする場合や、特定のタイプのトランスポート コントロールを使用してデータを送信したい場合に便利です。

+ +

アプリでネットワークを動的に選択して接続する手順は次のとおりです。

+ +
    +
  1. {@link android.net.ConnectivityManager} を作成します。
    2. +
  2. {@link android.net.NetworkRequest.Builder} クラスを使用して {@link android.net.NetworkRequest} オブジェクトを作成し、アプリで必要なネットワーク機能とトランスポート タイプを指定します。
    3. +
  3. 適切なネットワークがないかどうかをスキャンして調べるには、{@link android.net.ConnectivityManager#requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) requestNetwork()} または {@link android.net.ConnectivityManager#registerNetworkCallback(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) registerNetworkCallback()} を呼び出し、{@link android.net.NetworkRequest} オブジェクトと、{@link android.net.ConnectivityManager.NetworkCallback} の実装を渡します。検出した適切なネットワークに積極的に切り替えたい場合は、{@link android.net.ConnectivityManager#requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) requestNetwork()} メソッドを使用します。スキャンしたネットワークに積極的に切り替えずに通知のみを受信するには、代わりに {@link android.net.ConnectivityManager#registerNetworkCallback(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) registerNetworkCallback()} メソッドを使用します。
    4. +
+ +

適切なネットワークが検出されると、システムはそのネットワークに接続し、{@link android.net.ConnectivityManager.NetworkCallback#onAvailable(android.net.Network) onAvailable()} コールバックを呼び出します。このコールバックの {@link android.net.Network} オブジェクトを使用して、ネットワークに関する詳細な情報を取得したり、選択されたネットワークを使用するようにトラフィックを設定したりできます。

+ +

Bluetooth Low Energy

+

Android 4.3 では、Bluetooth Low Energy（Bluetooth LE）がプラットフォームでサポートされ、中央の役割として導入されました。Android 5.0 では、Android 搭載デバイスが Bluetooth LE の「周辺デバイス」として機能できるようになりました。アプリからこの機能を使用することで、アプリの存在を付近のデバイスに知らせることができます。たとえば、デバイスを歩数計や健康管理機器として機能させるアプリを作成して、それらのデータを他の Bluetooth LE 対応デバイスとやり取りすることができます。

+

新しい {@link android.bluetooth.le} API を使用すると、アプリからアドバタイズをブロードキャストしたり、応答の有無をスキャンして調べたり、付近の Bluetooth LE 対応デバイスとの接続を確立したりできます。新しいアドバタイズ機能やスキャン機能を使用するには、{@link android.Manifest.permission#BLUETOOTH_ADMIN BLUETOOTH_ADMIN} 権限をマニフェストに追加します。ユーザーは、Play ストアでアプリを更新またはダウンロードするときに、「Bluetooth接続情報: Bluetoothの制御（付近のBluetoothデバイスへの送信、詳細情報の取得など）をアプリに許可します」という権限をアプリに許可するかどうかたずねられます。

+ +

他のデバイスがアプリを検出できるように Bluetooth LE によるアドバタイズを開始するには、{@link android.bluetooth.le.BluetoothLeAdvertiser#startAdvertising(android.bluetooth.le.AdvertiseSettings, android.bluetooth.le.AdvertiseData, android.bluetooth.le.AdvertiseCallback) startAdvertising()} を呼び出し、{@link android.bluetooth.le.AdvertiseCallback} クラスの実装を渡します。このコールバック オブジェクトは、アドバタイズ操作の成否を知らせる通知を受信します。

+ +

Android 5.0 で導入された {@link android.bluetooth.le.ScanFilter} クラスをアプリで使用すると、必要な特定のタイプのデバイスのみを探すスキャンを実行できます。Bluetooth LE デバイスを探すためのスキャンを開始するには、{@link android.bluetooth.le.BluetoothLeScanner#startScan(android.bluetooth.le.ScanCallback) startScan()} を呼び出し、フィルタのリストを渡します。このメソッド呼び出しでは、{@link android.bluetooth.le.ScanCallback} の実装を渡し、Bluetooth LE のアドバタイズが検出されたときにそれを知らせるようにする必要もあります。

+ +

NFC の機能強化

+

Android 5.0 では、NFC をより幅広く柔軟に利用できるように、次の機能強化が追加されています。

+ + + +

Project Volta

+ +

新機能に加えて、Android 5.0 では特に電池寿命が向上しています。新しい API やツールを使用して、アプリの消費電力に関する情報の取得や消費電力の最適化を行ってください。

+ +

ジョブのスケジューリング

+

Android 5.0 で提供される新しい {@link android.app.job.JobScheduler} API を使用すると、システムが後で、または指定の条件（端末の充電時など）の下で、非同期に実行するジョブを定義することによって、電池寿命を最適化できます。ジョブ スケジューリングは、アプリで次のような状況を処理する場合に便利です。

+ + +

作業ユニットは {@link android.app.job.JobInfo} オブジェクトによってカプセル化されます。このオブジェクトでスケジューリング条件を指定します。

+ +

スケジューリング済みのタスクをどのように実行するのかを設定するには、{@link android.app.job.JobInfo.Builder} クラスを使用します。タスクが次のような特定の条件下で実行されるようにスケジューリングできます。

+ + + +

たとえば、次のようなコードを追加すると、タスクを定額制ネットワーク上で実行できます。

+ +
+JobInfo uploadTask = new JobInfo.Builder(mJobId,
+                                         mServiceComponent /* JobService component */)
+        .setRequiredNetworkCapabilities(JobInfo.NetworkType.UNMETERED)
+        .build();
+JobScheduler jobScheduler =
+        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
+jobScheduler.schedule(uploadTask);
+
+ +

端末の電力が安定している場合（つまり、端末が 2 分以上電源に接続されていて、電池が正常レベルにある場合）には、ジョブがまだ期限切れになっていなくても、実行の準備ができているスケジューリング済みのジョブがすべて実行されます。

+ +

{@link android.app.job.JobScheduler} API の使用例については、このリリースに付属している {@code JobSchedulerSample} の実装サンプルをご覧ください。

+ +

電池の使用統計情報を提供するデベロッパー向けツール

+ +

新しい {@code dumpsys batterystats} コマンドでは、端末での電池の使用に関して役立つ統計データが、一意のユーザー ID（UID）別に整理されて生成されます。次のような統計情報が生成されます。

+ + + +

出力をカスタマイズするための各種オプションについて調べるには、{@code --help} オプションを使用します。たとえば対象のアプリ パッケージについて、端末が最後に充電されてから現在までの電池の使用統計情報を出力するには、次のコマンドを実行します。 +

+$ adb shell dumpsys batterystats --charged <package-name>
+
+ +

{@code dumpsys} コマンドの出力に対して電池履歴ツールを使用すると、電力に関するイベントをログから取得して視覚的に表現する HTML を生成できます。これらの情報を利用することで、電池に関連した問題の把握や診断がしやすくなります。

+ +

職場向けや教育向けの Android

+

管理対象プロビジョニング

+ +

Android 5.0 では社内環境の中でアプリを実行するための新機能が提供されています。端末管理者は、ユーザーが既存の個人用アカウントを持っている場合に、管理対象プロビジョニングのプロセスを開始して、同時かつ別々に存在する「管理対象プロフィール」を端末に追加することができます。管理対象プロフィールに関連付けられたアプリは、管理対象外のアプリと一緒に、ユーザーのランチャー、最近使ったアプリ画面、通知に表示されます。

+ +

管理対象プロビジョニングのプロセスを開始するには、{@link android.content.Intent} で {@link android.app.admin.DevicePolicyManager#ACTION_PROVISION_MANAGED_PROFILE ACTION_PROVISION_MANAGED_PROFILE} を送信します。呼び出しが成功すると、システムから {@link android.app.admin.DeviceAdminReceiver#onProfileProvisioningComplete(android.content.Context, android.content.Intent) onProfileProvisioningComplete()} コールバックが起動されます。その後、{@link android.app.admin.DevicePolicyManager#setProfileEnabled(android.content.ComponentName) setProfileEnabled()} を呼び出してこの管理対象プロフィールを有効にすることができます。

+ +

デフォルトでは、一部の少数のアプリのみが管理対象プロフィールで有効になります。管理対象プロフィールで追加のアプリをインストールするには、{@link android.app.admin.DevicePolicyManager#enableSystemApp(android.content.ComponentName, android.content.Intent) enableSystemApp()} を呼び出します。

+ +

ランチャー アプリを開発している場合は、新しい {@link android.content.pm.LauncherApps} クラスを使用して、現在のユーザーの起動可能なアクティビティのリストや、関連するすべての管理対象プロフィールを取得できます。ランチャーでアイコン drawable に作業バッジを付けると、管理対象アプリを視覚的に目立たせることができます。バッジ付きのアイコンを取得するには {@link android.content.pm.PackageManager#getUserBadgedIcon(android.graphics.drawable.Drawable, android.os.UserHandle) getUserBadgedIcon()} を呼び出します。

+ +

新機能の使い方については、このリリースに付属している {@code BasicManagedProfile} の実装サンプルをご覧ください。

+ +

端末所有者

+

Android 5.0 では、端末所有者アプリの展開機能が導入されています。「端末所有者」は特殊なタイプの端末管理者で、第 2 ユーザーの作成や削除、端末全体の設定について、さらに詳細な操作を実行できます。端末管理者アプリでは {@link android.app.admin.DevicePolicyManager} クラスのメソッドを使用して、管理対象端末の設定、セキュリティ、アプリをきめ細かくコントロールできます。端末で有効にできる端末管理者は一度に 1 つだけです。

+ +

端末管理者を展開して有効にするには、端末がプロビジョニングされていない状態となっている間に、プログラミング アプリから端末への NFC データ転送を実行する必要があります。このデータ転送では、管理対象プロビジョニングで説明しているインテントのプロビジョニングの場合と同じ情報が送信されます。

+ +

画面の固定

+ +

Android 5.0 では、新しい画面固定 API が導入されています。これを使用すると、ユーザーがタスクから離れる操作や通知による割り込みを一時的に制限することができます。たとえば Android で、重要度の高い評価要件に対応した教育向けアプリや、単一用途のアプリ、またはキオスクアプリを開発している場合などに役立ちます。アプリで画面の固定を有効にすると、そのモードを終了するまで、ユーザーは通知を表示することも、他のアプリにアクセスすることも、ホーム画面に戻ることもできなくなります。

+ +

次の 2 つの方法で画面の固定を有効にすることができます。

+ + + +

タスクのロックが有効になると、次のような動作になります。

+ + + +

印刷フレームワーク

+ +

PDF をビットマップとしてレンダリング

+

新しい {@link android.graphics.pdf.PdfRenderer} クラスを使用して、PDF ドキュメントのページを印刷用のビットマップ画像にレンダリングできるようになりました。印刷可能なコンテンツの書き込み先となる、シーク可能な（つまり、コンテンツへのランダム アクセスが可能な）{@link android.os.ParcelFileDescriptor} を指定する必要があります。アプリでは、{@link android.graphics.pdf.PdfRenderer#openPage(int) openPage()} でレンダリング用のページを取得した後、{@link android.graphics.pdf.PdfRenderer.Page#render(android.graphics.Bitmap, android.graphics.Rect, android.graphics.Matrix, int) render()} を呼び出して、開いている {@link android.graphics.pdf.PdfRenderer.Page} をビットマップに変換できます。また、ドキュメントの一部分だけをビットマップ画像に変換したい場合は追加のパラメータを設定できます（たとえば、ドキュメントを拡大するためにタイル レンダリングを実装する場合など）。

+ +

新しいアプリの使用例については、{@code PdfRendererBasic} のサンプルをご覧ください。

+ +

システム

+

アプリの使用統計情報

+

新しい {@link android.app.usage} API を使用して Android 端末のアプリ使用履歴にアクセスできるようになりました。この API では、非推奨となった {@link android.app.ActivityManager#getRecentTasks(int, int) getRecentTasks()} メソッドよりも詳細な使用統計情報が提供されます。この API を使用するには、最初にマニフェストで {@code "android.permission.PACKAGE_USAGE_STATS"} 権限を宣言する必要があります。また、ユーザーも [設定] > [セキュリティ] > [アプリ] を通じてこのアプリの使用アクセス権を有効にする必要があります。

+ +

使用統計データはアプリ単位で収集され、毎日、毎週、毎月、毎年の各期間でデータが集計されます。データの最長保持期間は次のとおりです。

+ + + +

各アプリについて次のデータが記録されます。

+ + +

テストとユーザー補助

+ +

テストとユーザー補助の向上

+

Android 5.0 ではテストとユーザー補助に関する次のサポートが追加されています。

+ + + +

IME

+ +

入力言語の切り替えやすさの向上

+ +

Android 5.0 以降、ユーザーはプラットフォームでサポートされているすべてのインプット メソッド エディタ（IME）を簡単に切り替えられるようになります。指定された切り替え操作（通常はソフト キーボード上の地球アイコンのタップ）を行うと、それらの IME のすべてが循環して切り替わります。この動作変更は {@link android.view.inputmethod.InputMethodManager#shouldOfferSwitchingToNextInputMethod(android.os.IBinder) shouldOfferSwitchingToNextInputMethod()} メソッドによって実装されます。

+ +

また、次の IME に切り替え機能が組み込まれているかどうか（つまり、対象の IME が次に続く IME への切り替えをサポートしているかどうか）がチェックされるようになりました。切り替え機能のある IME から切り替え機能のない IME への循環切り替えは行われません。この動作変更は {@link android.view.inputmethod.InputMethodManager#switchToNextInputMethod(android.os.IBinder, boolean) switchToNextInputMethod()} メソッドによって実装されます。 + +

最新の IME 切り替え API の使用例については、このリリースに付属している最新のソフト キーボードの実装サンプルをご覧ください。IME の切り替えを実装する方法について詳しくは、入力方法の作成をご覧ください。 +

+ +

マニフェスト宣言

+ +

宣言可能な必須機能

+

次の値が {@code } 要素でサポートされるようになりました。これにより、アプリで必要としている機能を備えている端末にのみアプリをインストールできるようになります。

+ + + +

ユーザー権限

+ +

次の権限が {@code } 要素でサポートされ、アプリで特定の API へのアクセスに必要な権限を宣言できるようになりました。

+ + \ No newline at end of file diff --git a/docs/html-intl/intl/zh-cn/about/versions/lollipop.jd b/docs/html-intl/intl/zh-cn/about/versions/lollipop.jd new file mode 100644 index 0000000000000..a63c56e8bf3b2 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/about/versions/lollipop.jd @@ -0,0 +1,259 @@ +page.title=Android Lollipop + +@jd:body + + + + + + + + + + +
+ +
+ +
+
+

主なデベロッパー機能

+ +
+
+ + + + + + + +

Android 5.0 Lollipop は、これまでの Android の中で最も大きく刷新された意欲的なリリースです。

+ +

このリリースには、ユーザー向けの新しい機能だけでなく、デベロッパー向けに数多くの API が追加されています。これらの API を使用することで、携帯電話、タブレット、ウェアラブルに加え、テレビや自動車用にも Android を拡張できます。

+ +

新しいデベロッパー向け API の概要については、Android 5.0 API をご覧ください。Android 5.0 のユーザー向けの新機能については www.android.com をご覧ください。

+ + + +

アプリを実機でテストするには、
Android プレビュー システム イメージを使用して Nexus 5 または Nexus 7 のフラッシュに書き込みます。

+ + +

Material Design

+ +

Android 5.0 では新たに Material Design が導入され、拡張 UI ツールキットを使用することで新しいデザイン パターンをアプリに簡単に統合できるようになりました。

+ + + +

新しい 3D ビュー機能では、z レベルを設定することでビュー階層から要素を持ち上げることができるようになりました。また、リアルタイム シャドウ機能により、要素が移動しても影を追随させることができます。

+ + +

アクティビティ遷移機能が組み込まれたことで、美しいアニメーションを使って次の状態へスムーズに遷移できるようになりました。マテリアル テーマを使用すると、アクティビティの遷移がさらにスムーズになります。たとえば、アクティビティ間で共有視覚要素を使用できるようになりました。

+ + + +
+
+ +
+
+ 端末画面をクリックすると動作が再現されます +
+
+ + +

アプリ内のタップ コントロール（ボタン、チェックボックスなど）にリップル アニメーションを適用できます。 + +

XML でベクター ドローアブルを定義して、さまざまな方法でアニメーション化することも可能です。ベクター ドローアブルは定義を変更することなく拡大縮小できるため、単色のアプリ内アイコンに最適です。

+ +

システム管理の処理スレッドとして RenderThread が追加されており、メインの UI スレッドに遅延が発生してもアニメーションをスムーズに再生できます。

+ + +

パフォーマンス重視

+ +

Android 5.0 では、より高速でスムーズな演算処理が実現します。

+ +

新しい ART ランタイムに完全に移行しました。ART は基礎から徹底的に再構築したランタイムで、AOT（ahead-of-time）、JIT（just-in-time）、インタプリタ型のコードをまとめて処理できます。ARM、x86、MIPS アーキテクチャに対応した 64 ビット完全互換のランタイムです。

+ +

ART は、アプリのパフォーマンスと応答性を改善します。ガベージ コレクションを効率的することで、GC イベントによる一時停止の回数や時間を減らしました。垂直同期の期間にうまく適合するようになったことで、アプリがフレームをスキップすることもなくなります。また、メモリを動的に移動してフォアグラウンドのパフォーマンスも最適化しています。

+ +

Android 5.0 では、Nexus 9 の NVIDIA Tegra K1 で採用されている64 ビット アーキテクチャのプラットフォーム サポートを導入しています。最適化によって広いアドレス空間が提供され、特定の演算負荷の処理能力が向上しました。Java で記述されているアプリは、修正なしで自動的に 64 ビット アプリとして実行されます。ネイティブ コードを使用するアプリのためには、ARM v8、x86-64、MIPS-64 用の新しい ABI をサポートするため NDK を拡張しました。

+ +

Android 5.0 では、パフォーマンスをさらに向上させるため、A/V 同期についても改善に取り組みました。音声と映像のパイプラインを搭載したことでタイムスタンプの正確性が向上し、動画アプリやゲームのコンテンツの同期がスムーズに行われるようになりました。

+ + +

通知

+ +

Android 5.0 の通知は、より見やすく、アクセスしやすく、カスタマイズしやすくなりました。

+ + + +

さまざまな通知の詳細をロック画面に表示できるようになり、通知内容をすべて表示するか、一部だけ表示するか、表示しないかをユーザーが選択できます。

+ +

着信などの重要な通知は警告通知と呼ばれるフローティング ウィンドウに表示されるため、使用中のアプリを表示したまま応答したり破棄したりできます。

+ +

Android 5.0 では、通知に新しいメタデータを追加して、関連付けられている連絡先（ランク付け用）、カテゴリ、優先度を収集できるようになりました。

+ +

新たに追加されたメディア通知テンプレートを使用すると、最大 6 つの操作ボタンを使用して、一貫性のあるメディア コントロール（例: 「いいね」や「+1」）を通知に追加できます。RemoteViews はもう必要ありません。

+ + + +

アプリを大画面で

+ +

Android TV は、アプリを大画面で楽しむためのテレビ用プラットフォームを提供します。シンプルなホーム画面をベースに構成されており、ユーザーへのおすすめや音声検索によってコンテンツを簡単に見つけることができます。

+ +

Android TV なら、アプリやゲームを迫力の大画面で楽しむことができ、ゲーム コントローラなどの入力デバイスにも対応しています。Android では v17 サポート ライブラリに Leanback UI フレームワークが用意されており、離れた場所からでも操作しやすい 10 フィート UI を簡単に実現できます。

+ +

Android TV Input Framework（TIF）を使用すると、HDMI 入力、テレビチューナー、IPTV 対応受信機などからの動画ストリームを TV アプリで処理できます。TV Input が公開しているメタデータを使用することで、放送中のテレビ番組を検索できるようにしたり、ユーザーへのおすすめを表示したりできます。また、HDMI-CEC コントロール サービスを使用して、複数のデバイスを 1 つのリモコンで操作できるようにすることも可能です。

+ +

TV Input フレームワークを使用すると、さまざまな入力ソースからのテレビ番組をまとめ、ユーザーが 1 つのインターフェースで閲覧したり視聴したりできるようにすることができます。提供するコンテンツの TV Input サービスを作成することで、ユーザーが TV デバイスでコンテンツを視聴する可能性を高めることができます。

+ + + + + +

アプリのドキュメント化

+ +

Android 5.0 では、[概要]（以前は [最近]）のスペースをデザインしなおして用途を広げ、マルチタスクにも使えるようにしました。

+ +

新しい API を使用することで、アプリ内の各アクティビティを個別のドキュメントとして、他の最近の画面と並べて表示できます。

+ +

これにより、ユーザーがコンテンツやサービスにすばやくアクセスできるようになります。たとえば、生産性アプリのファイル、ゲームでのプレーヤーの組み合わせ、メッセージ アプリのチャットなどを、別々のドキュメントにして同時に表示できます。

+ + + +

進化した接続性

+ +

Android 5.0 に追加された新しい API を使用すると、アプリと BLE（Bluetooth Low Energy）の同時処理が可能になり、スキャン（セントラル モード）とアドバタイズ（ペリフェラル モード）の両方を行うことができます。

+ +

新しいマルチネットワーキング機能により、アプリから特定の機能を利用できるネットワーク（Wi-Fi、モバイル、従量制、特定のネットワーク機能を提供するネットワークなど）を探せるようになりました。ネットワークが見つかったら、アプリから接続を要求したり、切断やネットワーク変更に対して応答したりできます。

+ +

NFC API では、アプリから NFC AID（Application ID）を動的に登録できるようになりました。また、アクティブなサービスごとに望ましいカード エミュレーション サービスを設定したり、UTF-8 テキストデータを格納する NDEF レコードを作成したりすることも可能になりました。

+ + + +

高性能グラフィックス

+ +

Khronos OpenGL ES 3.1 をサポートしたことで、対応デバイスで実行するゲームやアプリに高性能な 2D / 3D グラフィックス機能を利用できるようになりました。

+ +

OpenGL ES 3.1 により、コンピュート シェーダー、ステンシル テクスチャ、アクセラレータによる視覚効果、高品質 ETC2/EAC テクスチャ圧縮、高度なテクスチャ レンダリング、標準化されたテクスチャ サイズ、レンダー バッファ フォーマットなど、さまざまな機能が追加されました。

+ + +
+ +

Gameloft の Rival Knights では、AEP の ASTC（Adaptive Scalable Texture Compression）と ES 3.1 のコンピュート シェーダーを使用して、ハイ ダイナミック レンジ（HDR）によるブルーム効果や詳細なグラフィックスを実現しています。

+
+ +

Android 5.0 には OpenGL ES 拡張をまとめた Android Extension Pack（AEP）も追加されており、テッセレーション シェーダー、ジオメトリ シェーダー、ASTC テクスチャ圧縮、サンプル単位での補間とシェーディングなど、高度なレンダリング機能を使用できます。AEP を使用することで、GPU を無駄なく利用して高性能なグラフィックスを実現できます。

+ + +

さらに強化された音声

+ +

新しい音声キャプチャ デザインにより、音声入力の待ち時間が短縮されました。新しいデザインには、ブロックが読み込み中にしか発生しない高速キャプチャ スレッド、ネイティブ サンプル レートでの高速トラック キャプチャ クライアント、チャンネル カウント、ビット深度、リサンプリングを提供する通常のキャプチャ クライアント、チャンネルのアップミックスとダウンミックス、ビット深度の調整などが含まれています。

+ +

マルチチャンネルの音声ストリーム ミキシングを使うと、5.1 や 7.1 を含め最大 8 つのチャンネルをミキシングできる本格的なオーディオ アプリを実現できます。

+ +

アプリでは、メディア コンテンツを公開したり、他のアプリが公開しているメディアを閲覧したり、その再生をリクエストしたりできます。コンテンツはクエリ可能なインターフェースで公開されるため、端末に保持する必要はありません。

+ +

また、特定のロケール、音質、レイテンシ速度に関連付けられた音声プロフィールを使うことで、合成音声によるテキスト読み上げをきめ細かくコントロールできます。新しい API では、合成エラーチェック、ネットワーク合成、言語検出、ネットワーク フォールバックなどへの対応も進めました。

+ +

Android が標準の USB オーディオ機器にも対応したことで、USB ヘッドセット、スピーカー、マイクなどの高性能デジタル機器も使用できるようになりました。Android 5.0 には、Opus 音声コーデックのサポートも追加されています。

+ +

メディア再生をコントロールするための新しい {@link android.media.session.MediaSession} API を使用することで、複数の画面にわたって一貫性のあるメディア コントロールや各種コントローラを簡単に表示できるようになりました。

+ + +

カメラと動画の拡張

+ +

Android 5.0 ではカメラ用の API が一新されており、YUV、Bayer RAW などの未加工フォーマットのキャプチャや、露出時間、ISO 感度、フレーム単位のフレーム持続時間などのパラメータ調整が可能です。カメラ パイプラインが完全に同期するようになったことで、対応デバイスを使えば未圧縮のフル解像度 YUV イメージを 30 FPS でキャプチャできます。

+ +

イメージと一緒に、ノイズモデルや光情報などのメタデータをカメラからキャプチャすることもできます。

+ +

ネットワーク経由で動画ストリームを送信するアプリでは、H.265 HEVC（High Efficiency Video Coding）を利用して動画データのエンコードとデコードを最適化できるようになりました。

+ +

Android 5.0 にはマルチメディア トンネリングのサポートも追加されており、超高解像度（4K）のコンテンツを楽しむための最適な環境を提供するほか、圧縮された音声データと動画データを一緒に再生することも可能です。

+ + + +
+ +

個人用と仕事用のアプリをまとめて表示し、バッジで簡単に識別できます。

+
+ + +

職場での Android

+ +

企業環境において BYOD（Bring-Your-Own-Device）を実現するには、管理されたプロビジョニング手続きによって端末の安全なワーク プロフィールを作成する必要があります。ランチャー内のアプリにワークバッジが表示されている場合は、そのアプリがワーク プロフィール内で IT 管理者によって管理されていることを表します。

+ +

通知の表示は個人プロフィールとワーク プロフィールが 1 つに統合されていますが、データはプロフィール別に分けて管理されます。同じアプリを両方のプロフィールで使用しても、それぞれのデータは別々に保管されます。

+ +

会社所有の端末は、IT 管理者が新しい端末として登録して端末所有者を設定します。会社所有の端末にグローバル端末設定を定義する端末所有者アプリをインストールすることで、従業員はその端末を持ち出すことができるようになります。

+ + + +

画面のキャプチャと共有

+ +

Android 5.0 では、アプリに画面キャプチャや画面共有の機能を追加できます。

+ +

ユーザーの承諾が得られれば、画面から安全性の低い動画をキャプチャしてネットワークに配信することも可能です。

+ + +

新しいタイプのセンサー

+ +

Android 5.0 には、新たに傾き検出センサーが追加され、対応デバイスでの操作の認識精度が向上しました。また、心拍数センサーも追加され、デバイスに接触している人の心拍数を記録できるようになりました。

+ +

新しい操作複合センサーを使用すると、「ウェイクアップ」（オンにする）ジェスチャー、「ピックアップ」（手に取る）ジェスチャー、「グランス」（ちらりと見る）ジェスチャーなどの特殊な操作を検出できます。

+ + + +

Chromium WebView

+ +
+ +
+ +

Android 5.0 の初期リリースには、Chromium M37 リリースをベースとした Chromium for {@link android.webkit.WebView} が含まれており、これにより WebRTC、WebAudio、WebGL がサポートされます。

+ +

Chromium M37 には、すべての Web Components 仕様（Custom Elements、Shadow DOM、HTML Imports、Templates）のネイティブ サポートも含まれています。つまり、Polymer とその Material Design 要素を WebView で、Polyfill なしで使用できるということです。

+ +

Android 4.4 以降の WebView は Chromium をベースにしていますが、Chromium レイヤは今後は Google Play から更新できるようになります。

+ +

Chromium の新バージョンがリリースされたとき、Android 5.0 以上で WebView を使用しているアプリのウェブ API の更新やバグ修正がある場合は、ユーザーが Google Play から更新することで WebView の最新の拡張とバグ修正を確実に適用できます。

+ + + +

ユーザー補助機能と入力

+ +

新しいユーザー補助機能 API を使用すると、視覚に障がいのないユーザーが操作できる画面上のウィンドウのプロパティに関する詳しい情報を取得し、UI 要素の標準入力操作とカスタム入力操作を定義できます。

+ +

新しい IME（Input Method Editor）API を使用すると、入力方法から直接他の IME に切り替えることができます。

+ + + +

省電力アプリ用のツール

+ +

新しいジョブ スケジューリング API を使用すると、システムのジョブの実行を延期することで電池消費量を最適化できます。延期したジョブは、後で実行するように指定したり、特定の条件（充電中、Wi-Fi 接続時など）を満たしたときに実行したりできます。

+ +

新たに追加された dumpsys batterystats コマンドで電池の使用統計情報を生成すると、システム全体での電池使用状況や、アプリが電池使用量にどの程度影響しているかを理解できます。電池が消費されたイベントの履歴、UID やシステム コンポーネントごとのおおよその消費電力量なども把握できます。

+ + +

新しい電池履歴ツールを使用すると、dumpsys batterystats で生成した統計情報を視覚化でき、電池関連のデバッグに便利です。このツールは https://github.com/google/battery-historian から入手できます。

diff --git a/docs/html-intl/intl/zh-cn/design/style/writing.jd b/docs/html-intl/intl/zh-cn/design/style/writing.jd new file mode 100644 index 0000000000000..7944c24c1ed20 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/design/style/writing.jd @@ -0,0 +1,311 @@ +page.title=写作风格 +page.type=设计 + +@jd:body + +

Android 的语言风格

+ +

撰写应用中显示的文本时，应力求简明、简易和友好。

+ +

简明

+ + + +

避免使用啰嗦、生硬的文字

+ +
+
+ +
错误做法
+ +
+ 如需更详细的说明，请参考手机随附的文档。 +
+ +
+
+ +
正确做法
+ +
+ 请阅读手机随附的说明。 +
+ +
+
+ +

请勿提供无关信息

+ +
+
+ +
从“设置向导”屏幕
+ + + + + + + + + + + + +
+ 登录… +
+ 你的手机需要与 Google 服务器通信
+ 然后才能登录到你的帐户。
+ 此过程最多可能需要 5 分钟。 +
+ +
+
+ +
从“设置向导”屏幕
+ + + + + + + + + + + + +
+ 登录… +
+ 你的手机正在连接 Google。
+ 此过程最多可能需要 5 分钟。 +
+ +
+
+ +

简易

+ + + +

关注用户的兴趣点，而不是技术细节

+ +
+
+ +
错误做法
+ +
+ 手动控制 GPS，以防止其他应用使用它 +
+ +
+
+ +
正确做法
+ +
+ 若想省电，请将“位置信息模式”切换为“耗电量低” +
+ +
+
+ +

将重要信息放在最前面

+ +
+
+ +
错误做法
+ +
+ 其他 77 人为此 +1 了，包括张三 +
+ +
+
+ +
正确做法
+ +
+ 张三及其他 76 人为此 +1 了 +
+ +
+
+ +

将用户目标放在最前面

+ +
+
+ +
错误做法
+ +
+ 触摸“下一步”，以完成 Wi-Fi 连接设置 +
+ +
+
+ +
正确做法
+ +
+ 要完成 Wi-Fi 连接设置，请触摸“下一步” +
+ +
+
+ + +

友好

+ + + +

避免使用令人困惑或令人厌烦的表达

+
+
+
错误做法
+ + + + + + + + + + + +
+ 抱歉！ +
+ “MyAppActivity”活动
+ （在应用“MyApp”中）无响应 +
+ +
+
+
正确做法
+ + + + + + + + + + + +
+ MyApp 无响应 +
+ 是否将其关闭？ +
+
+
+ + +

应避免使用的字词

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
不使用使用
一、二、三、四…1、2、3、4…
应用程序应用
cannot、could not、do not、did not、will not、you will缩写词：can’t、couldn’t、don’t、didn’t、won’t、you’ll 等等
okay、okOK
请、抱歉、谢谢故作礼貌可能会令用户生厌，特别是在提示“出错”的消息中。
+ 例外情况：在日语中，必须使用“请”。所以，祈使动词均应据此进行本地化（打开 -> 请打开）。 +
there is、there are、it is
+ 以及其他“无主语”表述（语法上称为虚指）		使用名词作为主语
abort、kill、terminatestop、cancel、end、exit
fail、failed 等“否定用法”一般情况下，请使用肯定用语
+ （例如，使用“do”而非“don’t”，除非在“不再显示…”、“无法连接”等情况下。）
me、I、my、mineyou、your、yours
确定吗？警告！应告诉用户后果，例如，“你的所有照片和媒体内容都将丢失”
+ +
+ +

设置文本格式

+ +

大写

+ + + + +

标点符号

+ diff --git a/docs/html-intl/intl/zh-cn/distribute/essentials/index.jd b/docs/html-intl/intl/zh-cn/distribute/essentials/index.jd new file mode 100644 index 0000000000000..26a61dccd5637 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/essentials/index.jd @@ -0,0 +1,34 @@ +page.title=Essentials for a Successful App +meta.tags="landing, quality" +page.tags="guidelines", "tablet", "quality" +section.landing=true +nonavpage=true + +@jd:body + +

+ A focus on quality should be part of your entire app delivery process: from + initial concept through app and UI design, coding and testing and onto a + process of monitoring feedback and making improvement after launch. +

+ +
+
+
+ +

Related resources

+ +
+
+
+
+
\ No newline at end of file diff --git a/docs/html-intl/intl/zh-cn/distribute/essentials/quality/core.jd b/docs/html-intl/intl/zh-cn/distribute/essentials/quality/core.jd new file mode 100644 index 0000000000000..61598fd7c5bda --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/essentials/quality/core.jd @@ -0,0 +1,998 @@ +page.title=应用的核心质量 +page.image=/distribute/images/core-quality-guidelines.jpg +page.type="分发" +page.metaDescription=应用程序质量的好坏将直接影响到你的应用程序的长期成功 － 这包括安装，用户评分和评论，参与和用户保留方面。 +@jd:body + +
+

质量标准

+
    +
  1. 设计和互动
    2. +
  2. 功能
    3. +
  3. 性能和稳定性
    4. +
  4. Google Play
    5. + +
+ +

测试

+
    +
  1. 设置测试环境
    2. +
  2. 测试流程
    3. +
+ +

你还应阅读以下内容：

+
    +
  1. 平板电脑应用的质量
    2. +
  2. 优化你的应用
    3. +
+ + +
+
+ +
+ +
+ +

+ Android 用户期望获得高品质的应用。你的应用要获得长期成功（体现在安装量、用户评分和评论、参与度和用户留存等方面），应用质量起着直接的作用。 +

+ +

+ 本文介绍一组简明的核心应用质量标准及相关的测试，旨在帮助你评估应用质量的基本要素。所有 Android 应用均应满足这些标准。 +

+ +

+ 你在发布应用之前，请根据这些标准对应用进行测试，确保应用能在众多设备上正常运行，满足 Android 的导航和设计标准，并为在 Google Play 商店开展推广做好准备。当然你的测试范围远不止这里所介绍的内容，不过本文的目的是说明所有应用都应具备的基本质量特征，因此你可以在测试计划中纳入这些内容。 +

+ +

+ 如果你要为平板电脑和/或 Google Play for Education 创建应用，还应考虑平板电脑应用的质量指南和 Education 指南中规定的其他质量标准。 +

+ +
+

+ 视觉设计和用户互动 +

+ + +
+ +

+ 遵循这些标准能够确保你的应用具备标准的 Android 视觉设计和互动模式（如果适用），从而提供一致、直观的用户体验。 +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 领域 + + ID + + 说明 + + 测试 +
标准设计 + UX-B1 + +

+ 应用遵循 Android 设计指南，采用常见的界面模式和图标： +

+ +
    +
  1. 应用不会重新定义系统图标的预期功能（例如“返回”按钮）。 +
    2. + +
  2. 如果系统图标触发的是标准界面行为，则应用不会使用完全不同的图标替换该系统图标。 +
    3. + +
  3. 如果应用提供标准系统图标的自定义版本，那么该图标要与系统图标十分相似并能够触发标准系统行为。 +
    4. + +
  4. 应用不会重新定义或滥用 Android 界面模式，例如有误导性或令用户困惑的图标或行为。 +
    5. +
+ 		+ CR 全部 +
+ 导航 + + UX-N1 + +

+ 应用支持标准的系统“返回”按钮导航，不会在屏幕上使用任何自定义的“返回按钮”提示。 +

+ 		+ CR-3 +
+ UX-N2 + +

+ 所有对话框均可以使用“返回”按钮关闭。 +

+ 		+ CR-3 +
+ UX-N3 + + 在任何位置按下“主屏幕”按钮即可转到设备的主屏幕。 + + CR-1 +
+ 通知 + + UX-S1 + +

+ 通知遵循 Android 设计指南。尤其是：

+ +
    +
  1. 如果可能，将多个通知放入一个通知对象中。 +
    2. + +
  2. 只有与进行中的活动（例如音乐播放或通话）相关时，通知才会持续保留。 +
    3. + +
  3. 通知中不包含广告或与应用核心功能无关的内容，除非用户选择接受这样的通知。 +
    4. +
+ 		+ CR-11 +
+ UX-S2 + +

+ 应用只为实现以下目的才使用通知： +

+ +
    +
  1. 说明与用户个人相关的上下文更改（例如收到消息）
    2. + +
  2. 展示与进行中的活动（例如音乐播放或通话）相关的信息/控件。 +
    3. +
+ 		+ CR-11 +
+ +

相关资源

+ +
+
+ +
+

+ 功能 +

+ + +
+ +

+ 遵循这些标准能够确保你的应用使用合适的权限级别，提供预期的功能行为。 +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 领域 + + ID + + 说明 + + 测试 +
+ 权限 + + FN-P1 + + 应用只请求为支持核心功能而需要的绝对最低级别权限。 + + CR-11 +
+ FN-P2 + +

+ 除非与应用的核心功能相关，否则应用不请求访问敏感数据（例如通讯录或系统日志）或访问用户付费服务（例如拨号或短信）的权限。 +

+
+ 安装位置 + + FN-L1 + +

+ 应用安装在 SD 卡上（如果应用支持）时可以正常工作。 +

+ +

+ 建议大多数的大型应用（大于 10MB）支持安装到 SD 卡。请参阅应用安装位置开发者指南，了解哪些类型的应用应该支持安装到 SD 卡。 +

+ 		+ SD-1 +
+ 音频 + + FN-A1 + + 音频不会在屏幕关闭时播放，除非这是应用的核心功能（例如应用是音乐播放器）。 + + CR-7 +
+ FN-A2 + + 音频不会在锁定屏幕后播放，除非这是应用的核心功能。 + + CR-8 +
+ FN-A3 + + 音频不会在主屏幕上或其他应用运行时播放，除非这是应用的核心功能。 + + CR-1,
+ CR-2 +
+ FN-A4 + + 音频会在应用返回前台时恢复，或者提示用户播放已处于暂停状态。 + + CR-1, CR-8 +
+ 界面和图形 + + FN-U1 + +

+ 应用既支持横向模式也支持纵向模式（如果可能）。 +

+ +

+ 不同的显示方向下，所展现的功能特性和操作应大致相同。对内容或视图做出细微更改是可接受的。 +

+ 		+ CR-5 +
+ FN-U2 + +

+ 在两种显示方向下，应用都占用整个屏幕，不会因为显示方向更改而出现黑边。 +

+ +

+ 为补偿屏幕图形的细微差异而使用少许黑边是可接受的。 +

+ 		+ CR-5 +
+ FN-U3 + +

+ 应用能正确处理显示方向之间的快速转换，而不会出现渲染问题。 +

+ 		+ CR-5 +
+ 用户/应用状态 + + FN-S1 + +

+ 应用转入后台时，不应再有任何服务处于运行状态，除非该服务与应用核心功能相关。 +

+ +

+ 例如，应用不得为了以下目的而让服务保持运行状态：为了接收通知而连接网络、保持蓝牙连接状态或为了让 GPS 保持开启状态。 +

+ 		+ CR-6 +
+ FN-S2 + +

+ 应用能够正确保留和恢复用户或应用状态。 +

+ +

+ 应用在离开前台时能够保留用户或应用状态，并防止因返回导航或其他状态更改导致的意外数据丢失。返回前台时，应用必须恢复保留的状态和其他任何重要的待处理事务，例如对可修改字段的更改、游戏进程、菜单、视频以及应用或游戏的其他部分。 +

+ +
    +
  1. 当应用从“最近使用的应用”切换器恢复时，它能够让用户返回到上次使用的准确状态。 +
    2. + +
  2. 当在设备从休眠（锁定）中被唤醒后，应用能够恢复并让用户准确返回到上次使用的状态。 +
    3. + +
  3. 当应用从主屏幕或“所有应用”重新启动时，应用会尽可能恢复为与之前状态最接近的状态。 +
    4. + +
  4. 在“返回”按键上，应用允许用户保存会因返回导航而丢失的任何应用或用户状态。 +
    5. +
+ 		+ CR-1, CR-3, CR-5 +
+ +

相关资源

+ +
+
+ +
+

+ 性能和稳定性 +

+ + +
+ +

+ 遵循这些标准能够确保应用提供用户期望的性能、稳定性和响应速度。 +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 领域 + + ID + + 说明 + + 测试 +
+ 稳定性 + + PS-S1 + + 应用不会在适配设备上崩溃、强制关闭、冻结或不正常运行。 + + CR 全部、SD-1、HA-1 +
+ 性能 + + PS-P1 + + 应用加载迅速，如果加载时间超过 2 秒则在屏幕上向用户提供反馈（进度指示器或类似提示）。 + + CR 全部、SD-1 +
+ PS-P2 + + 启用 StrictMode 之后（请参阅下文的 StrictMode 测试），在应用运行期间（包括玩游戏、动画和界面转换期间以及应用的其他部分）指示灯不会呈红色闪烁（StrictMode 的性能警告）。 + + PM-1 +
+ 媒体 + + PS-M1 + + 音乐和视频播放流畅，应用正常使用和加载期间没有中断、卡壳或其他异常声音。 + + CR 全部、SD-1、HA-1 +
+ 视觉质量 + + PS-V1 + +

+ 应用显示的图形、文本、图片和其他界面元素没有明显的失真、模糊或像素化。 +

+ +
    +
  1. 应用为所有适配的屏幕尺寸和外形规格提供高品质的图形，包括平板电脑等大屏幕设备。 +
    2. + +
  2. 菜单边缘、按钮和其他界面元素没有明显的走样。 +
    3. +
+ 		+ CR-all +
+ PS-V2 + +

+ 应用以可接受的方式显示文本和文本块。 +

+ +
    +
  1. 所用构图在所有支持的外形规格上都适用，包括平板电脑等大屏幕设备。 +
    2. + +
  2. 没有明显的字母或词语丢失。 +
    3. + +
  3. 按钮或图标中没有明显的不当文本换行。 +
    4. + +
  4. 文本与周围元素之间有充分的空间。 +
    5. +
+
+ +

相关资源

+ +
+
+ +
+

Google Play

+ + +
+ +

+ 遵循这些标准能够确保你的应用做好在 Google Play 上发布的准备。 +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 领域 + + ID + + 说明 + + 测试 +
+ 政策 + + GP-P1 + + 应用严格遵守 Google Play 开发者内容政策的条款，不提供不当内容，不使用其他方的知识产权或品牌等。 + + GP 全部 +
+ GP-P2 + +

+ 根据内容分级指南合理设置应用的心智成熟度。 +

+ +

+ 尤其要注意的是，对于需要请求相应权限以使用设备位置的应用，其心智成熟度不能设置为“所有人”。 +

+ 		+ GP-1 +
+ 应用详细信息页 + + GP-D1 + +

+ 应用置顶大图遵循此博文中介绍的指南。请确保： +

+ +
    +
  1. 应用商品详情包括高品质的置顶大图。 +
    2. + +
  2. 置顶大图不包含设备图片、屏幕截图，也不包含缩小后以及在应用适配的最小尺寸屏幕上显示时难以辨认的小文字。 +
    3. + +
  3. 置顶大图不能看起来像广告。 +
    4. +
+ 		+ GP-1、GP-2 +
+ GP-D2 + + 应用屏幕截图和视频不显示或引用非 Android 设备。 + + GP-1 +
+ GP-D3 + + 应用屏幕截图或视频不以误导性方式展示应用的内容和体验。 +
+ 用户支持 + + GP-X1 + + 对于 Google Play 页面的“评论”标签中常见的用户报告的错误，如果错误可重现而且在多种不同的设备上发生，则应予以解决。 + 如果错误只在少数设备上出现，但是这些设备十分受欢迎或者是新设备，则你仍要予以解决。 + + GP-1 +
+ +

相关资源

+ +
+
+ +
+

+ 设置测试环境 +

+ + +
+ +

+ 要掌控应用的质量，请设置合适的硬件或模拟器环境以进行测试。 +

+ +

+ 理想的测试环境应包括少量实际硬件设备，并且这些设备能够代表目前消费者可用的主要外形规格和硬件/软件组合。你不需要测试市场上的每种设备，只需关注少量代表性的设备，甚至是仅针对每种外形规格选用一两个设备即可。 +

+ +

+ 如果你不能获得实际硬件设备来进行测试，则应该设置模拟设备 (AVD) 以代表最常见的外形规格和硬件/软件组合。 +

+ +

+ 如果你不局限于基本测试，则可以向测试环境中添加更多设备、更多外形规格，或新的硬件/软件组合。你也可以增加测试次数、提高复杂性和质量标准。 +

+ +
+

+ 测试流程 +

+ + +
+ +

+ 这里的这些测试流程有助于你发现应用中的各类质量问题。你可以在你的测试计划中组合各项测试或综合运用各组测试。请参阅上文介绍的内容，了解与特定测试相关联的具体标准。 +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 类型 + + + + 测试 + + 说明 +
+ 核心套件 + + CR-0 + +

+ 浏览应用的各个部分：所有屏幕、对话框、设置和所有用户流程。 +

+ +
    +
  1. 如果应用运行修改或创建内容、播放游戏或媒体，请务必进入这些流程以创建或修改内容。 +
    2. + +
  2. 在使用应用期间，让网络连接、电池功能、GPS 或位置可用性以及系统加载等发生短暂变化。 +
    3. +
+
+ CR-1 + + 在每个应用屏幕上，按下设备的“主屏幕”键，然后从“所有应用”屏幕重新启动应用。 +
+ CR-2 + + 从每个应用屏幕，使用“最近使用的应用”切换器切换到其他正在运行的应用，然后返回正在测试的应用。 +
+ CR-3 + + 从每个应用屏幕（和对话框），按下“返回”按钮。 +
+ CR-5 + + 从每个应用屏幕，旋转设备，在横屏和竖屏之间切换至少三次。 +
+ CR-6 + + 切换到其他应用，以将测试应用转至后台。转到“设置”，检查测试应用在后台时是否有服务在运行。在 Android 4.0 及更高版本中，转到“应用”屏幕并找到“正在运行”标签中的应用。在早期版本中，使用“管理应用”查看运行中的服务。 +
+ CR-7 + + 按下电源按钮，让设备进入休眠状态，然后再次按下电源按钮唤醒屏幕。 +
+ CR-8 + + 将设备设置为按下电源按钮后锁定。按下电源按钮让设备进入休眠状态，然后再次按下电源按钮唤醒屏幕，然后解锁设备。 +
+ CR-9 + + 对于带有滑动键盘的设备，将键盘滑进并滑出至少一次。对于带有键盘底座的设备，将设备连接到键盘底座。 +
+ CR-10 + + 对于具有外部显示端口的设备，请插入外部显示器。 +
+ CR-11 + + 在通知抽屉中触发并查看应用能够显示的所有通知类型。如果适用（Android 4.1 及更高版本）展开通知并触碰提供的所有操作。 +
+ CR-12 + + 转到“设置”>“应用信息”检查应用请求的权限
+ 在 SD 卡上安装 + + SD-1 + +

+ 对安装到设备 SD 卡的应用（如果应用支持的话）重复核心套件测试。 +

+ +

+ 要将应用移动到 SD 卡，你可以使用“设置”>“应用信息”>“移动到 SD 卡”。 +

+
+ 硬件加速 + + HA-1 + +

+ 启用硬件加速并重复核心套件测试。 +

+ +

+ 要强制启动硬件加速（在设备支持的位置），请将 hardware-accelerated="true" 添加到AndroidManifest.xml中的 <application> 并重新编译。 +

+
+ 性能监控 + + PM-1 + +

+ 在启用 StrictMode 分析（如下所述）的情况下重复核心套件测试。 +

+ +

+ 密切关注垃圾回收及其对用户体验的影响。 +

+
Google Play + GP-1 + + 登录到开发者控制台查看你的开发者个人资料、应用说明、屏幕截图、置顶大图、心智成熟度设置以及用户反馈。 +
+ GP-2 + + 下载置顶大图和屏幕截图，将其缩小以匹配设备上的显示屏尺寸以及你定位的外形规格。 +
+ GP-3 + + 查看所有图形资源、媒体、文本、代码库，以及应用内其他打包的内容或下载的扩展文件。 +
+ 付款 + + GP-4 + + 浏览应用的所有屏幕，并进入所有应用内购买流程。 +
+ +

+ 使用 StrictMode 进行测试 +

+ +

+ 对于性能测试，我们建议在应用内启用 StrictMode，通过它捕获主线程上和其他线程上可能影响性能、网络访问、文件读/写等的操作。 +

+ +

+ 你可以使用 StrictMode.ThreadPolicy.Builder 设置每个线程的监控政策，并使用 detectAll() 在 ThreadPolicy 中启用所有受支持的监控。 +

+ +

+ 请务必使用 penaltyFlashScreen() 针对 ThreadPolicy 为违反策略的行为启用可视通知。 +

diff --git a/docs/html-intl/intl/zh-cn/distribute/essentials/quality/tablets.jd b/docs/html-intl/intl/zh-cn/distribute/essentials/quality/tablets.jd new file mode 100644 index 0000000000000..4b6eb5063c5eb --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/essentials/quality/tablets.jd @@ -0,0 +1,582 @@ +page.title=平板电脑应用的质量 +page.metaDescription=平板电脑是一个快速增长的Android的安装基础，提供了新的机会，为你的应用程序提供了新的机会。 +page.image=/distribute/images/tablet-guidelines-color.jpg +Xnonavpage=true +page.type="배포" + +@jd:body + +
+ +
+ +
+ +

+ 现在越来越多的平板电脑选择安装 Android 系统，这就为开发者提供了与用户互动和获利的新机会。本文档中介绍的相关指南旨在帮助你通过引人入胜的功能、精心设计的直观界面满足平板电脑用户的预期。 +

+ +

+ 虽然这些指南按照编号排列，但你从哪一项开始着手都没问题。对于每条指南，你都应根据你的应用酌情考虑是否采用其中的建议。不过，为了给客户提供最好的产品，建议你尽可能遵循这些指南。 +

+ +

+ 本文档中提供了相关资源的链接，这些资源可帮助你了解文中给出的各条建议。 +

+ +

1. 测试平板电脑应用的基本质量

+ +

为了打造上佳的平板电脑应用体验，首先要根据应用适配的设备类型和尺寸，确保你的应用满足相应的“应用核心质量标准”。有关完整信息，请参阅应用核心质量指南。 +

+ +

+ 在发布应用前，还应确保你的应用通过了基本的技术检查并符合相关发布标准，例如： +

+ + + +

如果你的应用已上传至 Google Play 开发者控制台，你可以浏览“优化提示”页，了解以上各项检查的结果。

+ + +
+

2. 针对大屏幕优化布局

+ +

+ 借助于 Android，开发在屏幕尺寸各异、外形规格不同的各类设备上都能良好运行的应用不再是难事。这种广泛的兼容性对你极其有利，因为你只需设计一个可广泛分发到所有适配设备的应用即可。不过，要让用户在各种屏幕配置下（特别是在平板电脑上）都能获得最佳体验，你需要针对各种适用的屏幕配置，优化应用的布局及其他界面组件。在平板电脑上，优化界面可让你充分利用多出来的可用屏幕空间，例如用来提供新功能、展示新内容或以其他方式提升用户体验，以加深与用户的互动。 +

+ +

+ 如果你的应用是针对手机开发的，而现在你准备将其分发到平板电脑，则可以先对布局、字体和间距稍作调整。在某些情况下，例如对于 7 英寸平板电脑或画面较大的游戏，你可能只需做这些调整就能让应用实现出色的视觉效果。而在另外一些情况下，例如对于大屏幕的平板电脑，你就需要重新设计界面的各个组成部分，将拉伸变形的的界面替换为高效的多窗格界面、更便捷的导航控件以及其他内容。 +

+ + +
+ +

舍弃拉伸变形的界面：在平板电脑上，单窗格布局会导致空白过多以及内容行过长。请利用内边距减少界面元素的宽度并考虑采用多窗格布局。

+
+ +

下面是一些建议：

+ + + + +

尤其需要注意的是，不要让你的布局在屏幕上出现拉伸变形的情况：

+ + + +

相关资源

+ +
+ + +

3. 充分利用多出来的屏幕区域

+ +
+ +

多窗格布局能在平板电脑屏幕上实现更好的视觉平衡效果，同时令实用性和可读性得到增强。

+
+ +

平板电脑屏幕可为你的应用提供更多的屏幕空间（横向模式下更是如此）。尤其是 10 英寸的平板电脑多出来的区域更大，但即使是 7 英寸的平板电脑，也提供了更多空间供你展示内容、吸引用户。

+ +

为在平板电脑上运行的应用设计界面时，请确保能够充分利用平板电脑上多出来的屏幕区域。下面是一些建议：

+ + + +

相关资源

+ +
+ +

4. 使用专为平板电脑屏幕设计的图形资源

+ +
+ +

为确保应用呈现最佳的视觉效果，请根据平板电脑普遍支持的屏幕密度，提供相应图标和位图。具体而言，你应按图标指南为操作栏、通知和启动器设计图标，并提供多种密度的图标，这样这些图标在所有屏幕上都会以合适的尺寸显示，而不会出现模糊或缩放等情况。

+ +

表 1：不同图标类型的原始资源尺寸。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
密度启动器操作栏小图标/上下文图标通知
mdpi48x48 像素32x32 像素16x16 像素24x24 像素
hdpi72x72 像素48x48 像素24x24 像素36x36 像素
tvdpi（使用 hdpi）（使用 hdpi）（使用 hdpi）（使用 hdpi）
xhdpi96x96 像素64x64 像素32x32 像素48x48 像素
xxhdpi144x144 像素96x96 像素48x48 像素72x72 像素
+ +

+ 作为最低要求，要为以下常用的平板电脑屏幕密度中的至少一种密度，提供适用版本的图标和位图资源： +

+ + +

其他提示：

+ + + +

相关资源

+ +
+ +

5. 调整字体大小和触控目标

+ +

要确保用户在平板电脑上能够轻松使用你的应用，请花些时间针对你要适配的各种屏幕配置调整平板电脑界面中的字体大小和触控目标。你可以通过可设置样式的属性或尺寸资源调整字体大小，也可以通过布局和位图绘制工具调整触控目标，如上所述。

+ +

下面是一些注意事项：

+ + +

相关资源

+ +
+ +

6. 调整主屏幕小部件的尺寸

+ +

如果你的应用中包含主屏幕小部件，需要注意以下几点，以确保用户在平板电脑屏幕上获得良好体验：

+ + + +

相关资源

+ +
+ + +

7. 提供适用于平板电脑用户的全套功能

+ +
平板电脑功能集
+ +

让你的平板电脑用户能够体验应用的最佳功能。下面是一些建议：

+ + + +

8. 确定合适的 Android 版本

+ +

+ 为确保你的应用适配尽可能多的平板电脑，你必须让应用定位到支持平板电脑的 Android 版本。对平板电脑的支持是从 Android 3.0（API 级别 11）开始的；对平板电脑、手机及其他设备的统一界面框架支持是从 Android 4.0 开始的 +

+ +

+ 你可以在清单文件的 <uses-sdk> 元素中设置应用定位的 Android 版本。在大多数情况下，你只要将该元素的 targetSdkVersion 属性设置为可用的最高 API 级别，即可正确定位合适的 Android 版本。 +

+ +

+ 作为最低要求，请检查 <uses-sdk> 元素以确保： +

+ +
    +
  1. + 使用 11 或更高值声明 targetSdkVersion（建议使用 14 或更高值）；或 +
    2. + +
  2. + 使用 11 或更高值声明 minSdkVersion。 +
    3. + +
  3. 如果声明 maxSdkVersion 属性，其值必须为 11 或更高。请注意，一般情况下不建议使用 maxSdkVersion。 +
    4. +
+ +

相关资源

+ +
+ +

9. 准确声明硬件功能依赖关系

+ +

+ 通常情况下，手机和平板电脑对传感器、相机、电话及其他功能提供的硬件支持会稍有不同。例如，许多平板电脑可以在“WLAN”配置下使用却不支持电话功能。 +

+ +

+ 因此，你可以向你的所有手机和平板电脑用户分发一个 APK，但要确保你的应用不会要求调用平板电脑通常不提供的硬件功能。否则，请在应用清单中将硬件功能声明为“未要求”，如下所述。 +

+ + + + +

+ 将硬件功能声明为“未要求”后，请务必在各种设备上测试你的应用。即使应用所需的硬件功能无法使用，应用功能也应该正常运行；如果可以，应用应该提供“优雅降级”和替代功能。 +

+ +

+ 例如，如果应用通常使用 GPS 设置地理位置，但设备不支持 GPS，那么此应用可以让用户手动设置地理位置。应用可以在运行时检查设备硬件功能并根据需要执行相应处理。 +

+ +

相关资源

+ +
+ +

10. 声明对平板电脑屏幕的支持

+ +

为确保能将应用分发到各式平板电脑上，你应在应用的清单文件中声明对各种平板电脑屏幕尺寸的支持，如下所示：

+ + + +

如果应用在清单中声明了 <compatible-screens> 元素，该元素应包含相关属性，用以列举应用适配的平板电脑屏幕的尺寸和密度组合。请注意，如果可能，你应避免在应用中使用 <compatible-screens> 元素。

+ +

相关资源

+ +
+ + +

11. 在 Google Play 中展示你的平板电脑界面

+ +

+ 为你的平板电脑应用创建了经过优化、内容丰富的界面后，请务必告知你的客户！下面是一些重要的方法，可帮助你向 Google Play 上的用户推广你的平板电脑应用。 +

+ +
+ + +

+ 上传平板电脑界面的屏幕截图 +

+ +

+ 平板电脑用户需要了解你的应用在平板电脑设备上（而非手机上）的效果。如果你开发了一款平板电脑应用，请务必将平板电脑界面的屏幕截图上传至 Google Play 开发者控制台。下面是一些相关指南： +

+ + + +

+ 更新应用说明和版本说明 +

+ + + +

+ 更新你的推广视频 +

+ +

+ 许多用户通过观看推广视频来了解应用，确定自己是否喜欢此应用。你可以根据用户的这一兴趣特点，在推广视频中着重介绍应用的平板电脑界面，以吸引平板电脑用户。下面是一些相关提示和指南： +

+ + + +

+ 在推广活动中突显你的平板电脑界面 +

+ +

+ 确保平板电脑用户可以通过你的推广活动、网站、社交信息、广告及其他地方了解你的平板电脑界面。下面是一些建议： +

+ + + +

相关资源

+ +
+ +
+

+ 12. 遵循在 Google Play 中发布应用的最佳做法

+ + +
+ +

+ 下面是一些在 Google Play 中成功发布的平板电脑应用的最佳做法。 +

+ +
+ +
+ +

+ 检查应用的优化提示 +

+ +

Google Play 开发者控制台现在提供”优化提示“页，可让你快速了解你的应用是否很好地遵循了有关平板电脑应用分发和质量的基本指南。要访问此页面，请登录到开发者控制台，通过“所有应用”加载相应应用，然后点击左侧导航栏中的“优化提示”。

+ +
+
+

如何发送反馈意见

+ +

请使用下面的链接发送反馈意见或申请人工审核你的“优化提示”。

+ +

在发送反馈意见之前，请务必先仔细阅读平板电脑应用质量指南的相关部分。

+ +

平板电脑专用联系表单 »

+
+
+ +

开发者控制台通过运行一系列检查来验证你的应用是否符合基本质量标准，然后为其创建“优化提示”页。如果发现任何问题，开发者控制台会在“优化提示”页上列出“待优化事项”来提醒你。

+ +

如果你为应用开发了平板电脑版本，请务必访问“优化提示”页，了解你应用的基本检查结果。如果此页中列出问题，建议你在应用中进行解决，并上传一个新的二进制文件以供分发（如果需要）。

+ +

如果你认为“优化提示”页列出的“待优化事项”不适用于你的应用或会影响你的应用在平板电脑上的运行质量，请使用平板电脑专用联系表单 » 通知我们。我们会审核你的应用并视情况更新你的“优化提示”页。

+ + +

确认应用的适配设备

+ +

+ 将应用上传至开发者控制台后，请检查 APK 的“受支持设备”列表，确保未遗漏任何应用要适配的平板电脑设备。 +

+ +

用一个 APK 进行分发

+ +

+ 建议你针对所有屏幕尺寸（手机和平板电脑）用一个 APK 发布你的应用，并使用一份 Google Play 商品详情。这种做法有以下几大优点： +

+ + + +

+ 如果需要，你也可以选择使用多 APK 支持提供你的应用，不过在大多数情况下，强烈建议你使用一个 APK 覆盖所有设备。 +

+ +

相关资源

+
+ + +
+

+ 为平板电脑创建测试环境 +

+ + +
+ +

+ 使用合适的硬件或模拟器环境进行测试，既评估你的平板电脑应用的核心质量，也评估应用在平板电脑上的质量。 +

+ +

+  要测试应用对核心质量标准的遵循情况，可以使用建议的测试环境，要测试应用在平板电脑上的质量，还需要在建议环境的基础上加入中等大小的平板电脑以及具有更多或更少硬件/软件功能的平板电脑。 +

+ +

表 1：下表列出了两种类型的设备，及其采用的平台版本、屏幕配置和硬件功能配置。典型的平板电脑测试环境可以包含其中的一类或两类设备。

+ + + + + + + + + + + + + + + + + + + + + + + + +
类型尺寸密度版本AVD 主题
7 英寸平板电脑large 或
-sw600		hdpi、
tvdpi		Android 4.0 及更高版本（API 级别 14 及更高）WXGA800-7in
10 英寸平板电脑xlarge 或
-sw800		mdpi、
hdpi、
xhdpi		Android 3.2 及更高版本（API 级别 13 及更高）WXGA800
+ +
+ +
+

diff --git a/docs/html-intl/intl/zh-cn/distribute/resources.jd b/docs/html-intl/intl/zh-cn/distribute/resources.jd new file mode 100644 index 0000000000000..71bd4665a23ee --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/resources.jd @@ -0,0 +1,56 @@ +page.title=你的语言的资源 +page.viewport_width=970 +section.landing=true +header.hide=1 +nonavpage=true +page.metaDescription=我们翻译了以下一些网站资源，希望能帮助你开始设计、开发和发布你的Android应用程序到全球。 + +@jd:body + +
+
+ +
+ +

你的语言的资源

+

我们翻译了以下一些网站资源，希望能帮助你开始设计、开发和发布你的Android应用程序到全球。

+ +

检查清单

+ +
+ +

Google Play 应用内结算

+ +
+ +

工具

+ +
+ +

培训

+ +
+ + +
+ diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/index.jd b/docs/html-intl/intl/zh-cn/distribute/tools/index.jd new file mode 100644 index 0000000000000..cf16d07334752 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/index.jd @@ -0,0 +1,56 @@ +page.title=工具与参考 +section.landing=true +nonavpage=true + +@jd:body + +

+此页面的资源将帮助你发布你的应用和游戏，获取用户，并从中获利。 +

+ +
+ +

发布与推出

+
+
+ +

宣传工具

+
+
+ +

开发者支持

+
+
+ +

开发者消息

+
+
+ +

更多

+
+
+ + + +
diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/launch-checklist.jd b/docs/html-intl/intl/zh-cn/distribute/tools/launch-checklist.jd new file mode 100644 index 0000000000000..f641dbe13c582 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/launch-checklist.jd @@ -0,0 +1,709 @@ +page.title=发布检查清单 +page.metaDescription=向用户发布应用的完整过程的基本概述。在开发的早期阅读这份清单将有助于你做出规划并在Google Play成功发布应用。 +page.image=/distribute/images/launch-checklist.jpg + +@jd:body + + + +
+ +

+ 在 Google Play 上发布应用以将其分发给用户之前，你需要准备好要发布的应用、进行测试并准备相关宣传材料。 +

+ +

+ 本页面旨在帮助你了解发布流程，以及在 Google Play 上成功发布商品所需的准备工作，另外还总结了一些需要你在通过 Google Play 发布应用之前完成的任务，例如创建已签名的发布版应用包 (APK)、了解应用的要求以及为各个应用创建商品页和图形资源。 +

+ +

+ 准备和发布任务已按先后顺序列出，这是为了让你对任务执行顺序有个大致了解。不过，你可以按适合自己的顺序来执行这些任务，也可以根据具体情况跳过某些步骤。 +

+ +

+ 在完成发布之前的各项工作时，你可以使用各种支持资源。每一步中都提供了相关链接。 +

+ +
+

+ 1. 了解发布流程 +

+ + +
+ +

+ 在开始执行此检查清单中的各个步骤之前，你应抽时间查看和了解整个发布工作流程，并熟悉该流程的工作原理。特别要注意的是，你或你的开发小组需要按照所有 Android 应用通用的流程准备应用以进行发布。发布工作流程文档中详细说明了发布的工作原理以及如何准备 APK 以进行发布。 +

+ +

+ 当你基本熟悉发布流程后，请继续阅读以了解在 Google Play 上发布应用时应注意哪些问题。 +

+ +

相关资源

+ +
+
+ +
+

+ 2. 了解 Google Play 政策和协议 +

+ + +
+ +

+ 请务必了解并遵守你在注册时接受的 Google Play 计划政策。Google Play 要求强制执行这些政策，违反任何一条都可能导致你的应用被暂停。如果屡次违规，你的开发者帐户将被终止。 +

+ +

相关资源

+ +
+
+ +
+

+ 3. 测试质量 +

+ + +
+ +

+ 在 Google Play 上发布应用之前，请务必确保这些应用在所有目标设备上都符合适用于所有 Android 应用的基本质量要求。你可以设置测试环境，然后测试应用是否符合一系列适用于所有应用的质量标准，以此来检查应用的质量。有关完整信息，请参阅应用核心质量指南。 +

+ +

+ 如果你的应用适用于平板电脑，请确保其能为你的平板电脑用户提供引人入胜的丰富体验。请参阅平板电脑应用的质量指南，了解如何针对平板电脑优化应用的相关建议。 +

+ +

+ 如果你要将应用发布到 Google Play for Education，则需确保这些应用适合中小学课堂且能提供非凡的教育价值。请参阅教育指南，了解教育类应用应具备哪些特征。 +

+ +

相关资源

+ +
+
+ +
+

+ 4. 确定应用的内容分级 +

+ + +
+ +

+ Google Play 要求你为应用设置内容分级，以便 Google Play 用户了解应用的心智成熟度级别。发布应用之前，你应先确认自己要使用哪一分级。有以下四种内容分级可供选择： +

+ + + +

+ Android 用户可以在其 Android 设备上设置要浏览的心智成熟度级别，Google Play 会根据该设置对应用进行过滤。因此，你选择的内容分级会影响应用对用户的分发情况。你可以在开发者控制台中为应用指定（或更改）内容分级，无需在应用二进制文件中进行任何更改。 +

+ +

相关资源

+ +
+
+ +
+

+ 5. 确定分发国家/地区 +

+ + +
+ +

+ 借助 Google Play，你可以控制将应用分发到哪些国家和地区。为了尽可能扩大覆盖面和潜在客户群，你通常会希望将应用分发到所有适用的国家和地区。不过，由于业务需求、应用要求或发布时的依赖关系，你可能需要从分发范围中排除一个或多个国家/地区。 +

+ +

+ 请务必尽早确定目标国家/地区，因为这可能会影响： +

+ + + +

+ 确定目标国家/地区后，你应该评估应用及其 Google Play 商品详情是否需要本地化，然后在预订的发布日期之前就开始本地化工作。 +

+ +

+ 请参阅本地化检查清单，了解本地化流程中的关键步骤和注意事项。 +

+ +

相关资源

+ +
+
+ +
+

+ 6. 确认应用的总大小 +

+ + +
+ +

+ 应用的总大小会对应用的设计以及在 Google Play 上的发布产生影响。目前，在 Google Play 上发布的 APK 最大不得超过 50MB。如果你的应用超过该上限或要提供辅助下载，则可以使用 APK 扩展文件。Google Play 会将扩展文件免费托管在其服务器基础架构上，并自动处理这些文件下载到设备的过程。 +

+ + + +

+ 在分发大型应用时，使用 APK 扩展文件是一种经济高效的简便方法。不过，使用 APK 扩展文件需要你在应用二进制文件中稍作更改，因此你需要在创建发布版 APK 之前完成这些更改。 +

+ +

+ 为了尽可能精简应用的二进制文件，请务必在构建发布版 APK 时运行 Proguard 工具或类似的代码混淆工具。 +

+ +

相关资源

+ +
+
+ +
+

+ 7. 确认应用的平台和屏幕兼容性范围 +

+ + +
+ +

发布应用之前，请务必确保你的应用可在目标 Android 平台版本和设备屏幕尺寸上正常运行。 +

+ +

+ 从应用兼容性角度来看，Android 平台版本由 API 级别定义。你应该使用 <minSdkVersion> 确认你的应用兼容的最低版本，因为这将影响已发布的应用在 Android 设备上的分发情况。 +

+ +

+ 对于屏幕尺寸，你应该确认应用可在支持的各种屏幕尺寸和像素密度上正常运行且拥有精美外观。你还应按照支持跨屏中给出的建议，为多种屏幕尺寸提供相应的支持。如果你无法提供跨屏支持，请使用 <supports-screens> 声明应用支持的最小屏幕尺寸。Google Play 会据此对你的应用做出限制，只将其提供给屏幕尺寸大于或等于已声明尺寸的设备。 +

+ +

+ 要更好地了解目前 Android 平台版本和屏幕尺寸在所有 Android 设备上的普及情况，请参阅设备信息中心图表。 +

+ +

相关资源

+ +
+
+ +
+

+ 8. 决定你的应用是免费还是付费 +

+ + +
+ +
+ +
+ +

+ 在 Google Play 上，你可以发布免费下载的应用和付费下载的应用。免费应用可供 Google Play 中的所有 Android 用户下载。付费应用仅供其所在国家/地区支持付费下载且已在 Google Play 中注册了付款方式（例如信用卡或运营商直接代扣）的用户下载。 +

+ +

+ 决定你的应用是否免费非常重要，因为在 Google Play 上，免费应用必须始终免费。 +

+ + + +

+ 如果你的应用是付费应用或者你要销售应用内商品，你需要先设置 Google 电子钱包商家帐户，然后才能发布应用。 +

+ +

相关资源

+ +
+
+ +
+

+ 9. 考虑使用应用内结算 +

+ + +
+ +

+ 借助 Google Play 应用内结算，你可以在应用中销售数字内容。你可以使用该服务销售众多内容，包括可下载内容（例如媒体文件或照片）和虚拟内容（例如游戏关卡或魔药）。借助应用内结算服务，你可以在应用内销售一次性购买的商品，还可以销售订阅。这有助于你在应用安装后的整个生命周期内都能获利。 +

+ +

+ 如果你希望找到更多方法以通过应用获利并建立与用户的互动，则应考虑使用“应用内结算”或“Instant Buy”服务。这些服务深受用户和开发者的欢迎。要使用“应用内结算”和“Instant Buy”，你需要对应用的二进制文件进行更改。因此，你需要先完成更改并测试实施情况，然后才能创建发布版 APK。 +

+ +

相关资源

+ +
+
+ +
+

+ 10. 设置商品价格 +

+ + +
+ +

+ 如果你的应用是付费应用或者你要销售应用内商品或实体商品，Google Play 可让你针对全球市场的用户为商品设置以不同货币为单位的价格。你可以分别使用不同货币设置价格，以便根据市场情况和汇率灵活调整你的价格。 +

+ +

+ 发布应用之前，请想好如何为你的商品定价及以不同货币为单位的价格各是多少。之后，你可以通过开发者控制台设置以所有可用货币为单位的各种价格。 +

+ +

相关资源

+ +
+
+ +
+

+ 11. 开始本地化 +

+ + +
+ +

+ 确定目标国家/地区后，你最好评估一下你的本地化需求，确保你的应用已国际化，并在预订的发布日期之前就开始本地化工作。 +

+ +

+ 除了应用设计外，你至少还应考虑本地化工作中的三个方面： +

+ + + +

+ 请参阅本地化检查清单，了解本地化流程中的关键步骤和注意事项。 +

+ +

+ 要本地化你的商品详情，请先创建并完成应用标题、说明和宣传文字。将所有这些信息收集起来，然后发送给相关人员进行本地化。在应用更新时，你也可以选择翻译“最近更改”的文本。之后，你可以在开发者控制台中添加本地化的商品详情，或者选择让 Google Play 将你的商品详情自动翻译成你支持的语言。 +

+ +

+ 要让你的应用详情吸引全球的用户，关键是创建本地化版本的宣传图片、屏幕截图和视频。例如，应用的置顶大图中可能包含文字，这些文字应翻译成相应语言以获得最佳效果。你可以为每种目标语言创建相应版本的宣传图片，并将它们上传到开发者控制台。如果你提供宣传视频，则可以创建本地化版本的视频，然后添加指向各目标语言版本的视频的链接。 +

+ +

+ 完成翻译后，根据需要将翻译放入应用的资源中并测试能否正常加载。在上传资源和配置商品详情时，请保存应用的翻译版商品详情以供日后使用。 +

+ +

相关资源

+ +
+
+ +
+

+ 12. 准备宣传图片、屏幕截图和视频 +

+ + +
+ +

+ 在 Google Play 上发布应用时，你可以提供各种高品质的图形资源，用来宣传你的应用或品牌。应用发布后，这些资源将显示在你的商品详情页、搜索结果及其他位置上。这些图形资源是商品详情页成功与否的关键，它们能吸引用户的注意力并让用户参与互动。因此，你应考虑聘请专业人士为你制作这些资源。屏幕截图和视频也相当重要，因为它们将展示应用的外观、使用或操作方式及其独特之处。 +

+ +

+ 所有的图形资源均应精心设计以便足够醒目，并以多彩、有趣的方式突显你的应用或品牌。这些资源应该采用相同的徽标和图标，以便用户在下载应用后可以在“所有应用”启动器中找到你的应用。你的图形资源还应与你发布的所有应用的图形资源（也会显示在商品详情页上供用户查看）相互配套。 +

+ +

+ 为了帮你将应用更有效地推广给全球用户，Google Play 允许你创建本地化版本的宣传图片、屏幕截图和视频并上传到开发者控制台中。当用户访问你应用的商品详情时，Google Play 会向其展示你针对该用户所用语言提供的宣传图片、屏幕截图和视频。 +

+ +

+ 要本地化你的宣传图片，你可以翻译所有嵌入的文本、使用不同的图像或展示方式，或者改变你的营销方式，以尽可能满足使用特定语言的用户的需求。例如，如果你的置顶大图或宣传图片中包含嵌入的商品名称或宣传口号，则可以将名称或口号翻译成相应语言，然后添加到本地化版本的宣传图片中。 +

+ +

+ 由于本地化的图形资源和视频非常重要，因此你应在预订的发布日期之前就开始创建并进行本地化。 +

+ +

相关资源

+ +
+
+ +
+

+ 13. 构建并上传发布版 APK +

+ + +
+ +

+ 当确定你的应用符合界面、兼容性和质量要求后，你可以构建应用的发布版本。之后，你可以将发布版 APK 上传到开发者控制台并分发给用户。 +

+ +

+ 所有应用的发布版 APK 准备流程都一样，无论应用采用哪种分发方式。一般情况下，该流程包括基本的代码清理和优化、构建和使用发布密钥签名以及最后的测试这几部分。 +

+ +

+ 如需了解如何创建发布版应用的完整详情，请参阅准备发布。 +

+ +

+ 准备好发布版 APK 后，你可以将其上传到开发者控制台。如果需要，你可以在发布之前将 APK 替换为较新的版本。 +

+ + +
+

+ 14. 计划 Beta 版的发布 +

+ + +
+ +
+
+

+ 简单的 Beta 测试 +

+ +

+ Google Play 允许你在世界范围内设立 Alpha 版和 Beta 版测试者小组。下次登录到开发者控制台时请别忘记了解这一强大的功能。 +

+
+
+ +

+ 在发布应用之前收集用户的真实反馈是很有必要的，特别是发布新应用时，应该收集更多反馈。我们强烈建议你向主要目标市场的用户分发应用的预览版本，并让这些用户能够方便地向你提供反馈和报告错误。 +

+ +

+ Google Play 可以帮助你为应用设置 Beta 测试计划。登录到开发者控制台并上传你的 APK 之后，你可以设立用户小组，以便进行应用的 Alpha 版和 Beta 版测试。你可以先进行小范围的 Alpha 版测试，然后推进到更大范围的 Beta 版测试。用户被添加到小组之后，他们可以访问你应用的商品详情并安装应用。 + Alpha 或 Beta 版本的用户不能留下评论或评分，因此你在 Google Play 上的评分不会受到不利影响。你需要安排具体途径以便用户提供测试反馈，例如 Google 论坛或 Google+。 +

+ +

+ 收到的反馈可以帮助你调整界面、翻译和商品详情，以确保为用户提供优质体验。 +

+ + +
+

+ 15. 填写应用的商品详情 +

+ + +
+ +

+ 在 Google Play 上，应用的商品信息会在用户的 Android 设备或网络上的以下页面中显示给用户：应用的商品详情页；用户为详细了解应用而访问的页面；用户决定购买或下载应用的页面上。 +

+ +

+ 为了让你宣传应用以及在商品详情页上与用户互动，Google Play 提供了许多方式，包括多彩的图片、屏幕截图和视频，本地化的说明、发布详情以及指向你其他应用的链接。当你准备发布应用时，请确保充分利用商品详情页提供的所有资源，让你的应用尽可能地引人入胜。 +

+ +

+ 你应在预订的发布日期之前就开始规划商品页，准备本地化的说明以及高品质的图形资源、屏幕截图和视频等。 +

+ +

+ 当临近预订的发布日期时，你应该熟悉开发者控制台中与商品详情配置页相关的所有字段、选项和资源。收集此页面上的信息和资源时，请将它们输入或上传到开发者控制台中，直到完成该页面，可以进行发布。 +

+ +

+ 在开发者控制台中为应用设置地理位置定位后，请记得针对所有支持的目标语言添加本地化的商品详情、宣传图片等。 +

+ +

+ 如果你的应用适用于平板电脑，请确保至少加入一张应用在平板电脑上运行时的屏幕截图，并在应用说明、版本备注、宣传活动及其他位置注重介绍你的应用支持平板电脑。 +

+ +

相关资源

+ +
+
+ +
+

+ 16. 在宣传活动中使用 Google Play 徽章和链接 +

+ + +
+ +

+ Google Play 徽章是官方品牌标识，你可以使用该徽章向 Android 用户推广你的应用。使用 Google Play 徽章生成器可快速创建徽章，让用户从网页、广告、评论等链接到你的商品。你还可以使用特殊的链接格式，将用户直接链接到你的商品详情页、商品列表或搜索结果页。 +

+ +

+ 为了帮你的应用在发布后获得用户关注，强烈建议你通过宣传活动来支持应用的发布，这些宣传活动应通过尽可能多的渠道、向尽可能多的国家/地区介绍你的商品。例如，你可以通过广告展示、社交网络或博客、视频及其他媒体、采访和评论，或者任何其他可用渠道推广应用的发布。 +

+ +

相关资源

+ +
+
+ +
+

+ 17. 最终检查和发布

+ + +
+ +

+ 如果你认为已做好发布准备，请登录到开发者控制台，花些时间做最后几项检查。 +

+ +

+ 请确保： +

+ + + +

+ 你的应用现在随时可以发布了！ +

+ +

+ 如果你要发布更新，请务必阅读发布更新的相关要求。 +

+ +

+ 当一切就绪后，请点击开发者控制台中的发布按钮。几个小时内，你的应用就会提供给广大用户，你的商品页将显示在 Google Play 上，供用户浏览、搜索或从宣传资料中链接到该页面。 +

+ +

相关资源

+ +
+
+ +
+

+ 18. 在发布后为用户提供支持 +

+ + +
+ +

+ 发布应用或应用更新后，请务必为你的客户提供相关支持。及时周到的支持可让用户获得更好的体验，你的商品也就能获得更高的评分和更多的好评。如果你积极响应用户的需求和反馈，他们可能会与你的应用进行更多互动，还会向其他人推荐你的应用。如果你运用多种方式开展宣传活动，这种效果在应用发布后会更加明显。 +

+ +

+ 你可以通过多种方式与用户保持联系并为其提供支持。其中最常见的就是在商品详情页上提供你的支持电子邮件地址。除此之外，你还可以提供其他支持方式，例如论坛、邮寄名单或 Google+ 信息页。Google Play 小组会为用户提供下载、安装和付款方面的支持，但其他方面的问题则由你自行解决。由你向用户提供支持的示例包括：功能请求、应用的使用问题以及兼容性设置问题。 +

+ +

+ 发布应用后，你应： +

+ + + + +

相关资源

+ +
diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/localization-checklist.jd b/docs/html-intl/intl/zh-cn/distribute/tools/localization-checklist.jd new file mode 100644 index 0000000000000..b2ba2ff86ae91 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/localization-checklist.jd @@ -0,0 +1,698 @@ +page.title=本地化检查清单 +page.metaDescription=把握 Android 和 Google Play 所提供的全世界观众的优势。阅读此清单以获得如何将产品送到世界各地的市场的概述。 +page.image=/distribute/images/localization-checklist.jpg +page.type="배포" + +@jd:body + + + +
+ +
+

+ Android 和 Google Play 让你可以面向全球的用户提供应用，其中日本、韩国、印度、巴西和俄罗斯等国家/地区的目标用户群正在迅速扩展。有鉴于此，我们强烈建议你本地化你的应用，因为这样可以最大程度地增加应用的分发范围，获得全球各地用户的评分。 +

+ +

+ 本地化涉及到很多任务，贯穿应用开发的整个周期，因此务必要提前做出规划。本文旨在帮助你了解本地化的主要方面，以便你做好准备，通过 Google Play 向全球成功发布自己的应用。 +

+ +
+

+ 1. 确定目标语言和语言区域 +

+ + +
+ +

+ 确定要向哪些国家/地区发布你的应用并了解这些国家/地区所用的语言，是准备本地化的过程中基本且重要的一步。对于具有巨大市场商机、但英语或其他国际性语言并不普及的国家/地区来讲，将应用本地化尤为重要。 +

+ +

+ 对于国际用户，你可以从以下这三个主要方面来管理自己的应用：国家/地区、语言区域和语言。其中，语言是本地化的主要考虑因素（语言区域也很重要，因为日期的格式、时间、货币及其他类似信息也都存在差异）。用户可以控制其 Android 设备上使用的语言和语言区域，反过来这些因素也会影响应用的显示方式。 + +

+ +

+ 通常来说，你首先要根据整体市场规模和商机、应用类别、竞争格局、本地定价和金融状况等因素来确定要定位的国家/地区，然后再基于你的国家/地区定位，确定应用要支持的语言。 +

+ +

+ 随后，你可以决定是针对目标国家/地区的部分语言还是全部语言进行本地化。合理的做法是，先针对一种主要的地区性语言进行本地化，然后随着用户群的扩大增添更多语言。 +

+ +

+ 确定目标语言之后，你就可以安排开发、翻译、测试和市场营销工作重点围绕这些市场展开。 +

+ +

相关资源

+ +
+
+ +
+

+ 2. 本地化设计 +

+ + +
+ +

确定本地化的目标语言之后，请评估在应用中支持这些语言需要完成哪些工作并提早做出规划。要考虑的事项包括每种语言的词汇扩展、脚本要求、字符间距、换行限制、支持文字“从左到右”和“从右到左”，以及其他可能遇到的问题。 +

+ +

+ 设计一套灵活的布局 +

+ +

+ 在创建布局时，确保包含文字的界面元素拥有充足的空间。最好在满足你的语言的基础上多出部分空间（通常留出 30% 的空间）以适应其他语言。 +

+ +

+ 另外，元素应能够横向或纵向扩展，以便可以适应不同宽度和高度的界面字符串或输入文本。任何目标语言的字符串都不应与边框或屏幕边缘重叠。 +

+ +

+ 如果界面设计得当，通常你就可以针对所有支持的语言使用一套布局。有关详情，请参阅构建灵活的界面。 +

+ +

+ 根据需要使用备用布局 +

+ +

+ 如果你的界面不能很好地适应某种目标语言，那么你可以单独为该语言创建一套备用布局。Android 可让你很轻松地针对特定语言、语言区域、屏幕尺寸等，声明要加载的多种布局和其他资源，只需使用相应的资源限定符做出标记即可。虽然备用布局可提供相应的灵活性，但使用它会导致随着时间推移，应用的维护难度增加。因此一般来说，建议你最好使用一套更灵活的布局。 +

+ +

+ 支持 RTL 布局和文本 +

+ +

+ 如果你要发布应用的国家/地区使用从右到左 (RTL) 的文字阅读方向，则你应该考虑尽可能地支持 RTL 布局以及相应的文本显示和编辑。 +

+ +

+ Android 4.1 引入了对双向文字的有限支持，支持应用以从左到右 (LTR) 和从右到左 (RTL) 的方向显示和编辑文本。Android 4.2 增加了对 RTL 布局的完整原生支持（包括布局镜像），因此你可以为所有用户提供一致的优质体验。 +

+ +

+ Android 4.2 用户至少可以轻松添加基本的 RTL 布局镜像，这对满足 RTL 用户需求大有帮助。 +

+ +

+ 针对日期、时间、数字和货币采用系统提供的格式 +

+ +

+ 如果你的应用需要指定因语言区域不同而不同的日期、时间、数字、货币和其他实体，请务必使用系统提供的格式，而不要使用应用专有的格式。请注意，并非所有的语言区域都使用相同的千位分隔符、小数点或百分比符号。 +

+ +

+ Android 提供了多种实用工具，用于在不同的语言区域中设置格式、进行转换：例如适用于日期的 DateUtils 和 DateFormat；适用于数字和货币的 String.format() 或 DecimalFormat；适用于电话号码的 PhoneNumberUtils 等。 +

+ +

+ 假定用户的语言区域并据此强制设置格式，会导致在用户更改语言区域时引发问题。强烈建议你使用系统提供的格式和各种实用工具。 +

+ +

+ 包括一套完整的默认资源 +

+ +

+ 提供一整套默认资源可以确保无论是何种语言或语言区域，你的应用都能正常运行。应用的默认资源是指没有使用任何语言或语言区域限定符标记的资源，例如 res/drawable/ 和 res/values/ 中存储的资源。如果你的应用试图加载目前的语言或默认资源集中没有的资源，则会崩溃。 +

+ +

+ 无论你在应用中使用的默认语言是什么，请务必在默认的资源目录中存储相关的布局、图形内容和字符串，且不使用语言或语言区域限定符。 +

+ +

相关资源

+ +
+
+ +
+

+ 3. 管理字符串的本地化

+ + +
+ +

+ 妥善管理应用的界面字符串非常重要，这样你才能为用户提供优质的体验，并让本地化工作事半功倍。 +

+ +

+ 将所有字符串放入 strings.xml 中 +

+ +

+ 在构建应用时，请注意不要硬编码任何字符串，而是在默认的 strings.xml 文件中将所有字符串声明为资源，这样便于更新和进行本地化。strings.xml 文件中的字符串可以抽取出来、进行翻译，然后再集成回应用（使用相应的限定符），无需对编译后的代码进行任何更改。 +

+ +

+ 如果你生成带有文字的图片，也请将这些字符串放入 strings.xml，并在翻译之后重新生成图片。 +

+ +

+ 遵循针对界面字符串的 Android 指南 +

+ +

+ 在设计和开发界面时，请务必密切注意你与用户交流的方式。一般而言，使用友好而不失简洁、简明而且精炼的风格，并且整个界面应采用一致的风格。

+ +

+ 请务必阅读并遵循写作风格和字词选择方面的 Android 设计建议。这样做能够让你的应用更加美观，并且有助于用户快速理解你的界面。 +

+ +

+ 另外，请尽可能使用 Android 标准术语，例如对于界面元素，使用“操作栏”、“选项菜单”、“系统栏”、“通知”等。确保 Android 术语的正确性和一致性可让翻译工作更容易进行，从而为用户带来更好的最终产品。 +

+ +

+ 为声明的字符串提供充分的上下文 +

+ +

+ 在 strings.xml 文件中声明字符串时，确保清楚说明使用该字符串的上下文。此信息对翻译人员来说十分重要，有助于提高翻译质量，也有助于你始终有效地管理字符串。 +

+ +

+ 下面是一个例子： +

+ +
<!-- 用于提交表单的操作。此文本显示在可容纳 30 个字符的按钮上-->
<string name="login_submit_button">Sign in</string>
+

+ 你需要提供的上下文信息包括： +

+ + + +

+ 标记不应翻译的信息部分 +

+ +

+ 有时候字符串中包含不应被翻译为其他语言的文本。常见的示例包括代码、某个值的占位符、特殊符号或名称。在准备翻译字符串时，请查找并标记应该保留原样而不用翻译的文本，这样翻译人员就不会更改这些内容。 +

+ +

+ 要标记不应翻译的文本，请使用 <xliff:g> 占位符标记。以下示例标记可确保文本“%1$s”在翻译过程中不会被更改（否则这条消息会被破坏）： +

+ +
<string name="countdown">
    <xliff:g id="time" example="5 days>%1$s</xliff:g>until holiday
</string>
+

+ 在声明占位符标记时，请务必添加说明此占位符用途的 ID 属性。如果你的应用稍后会替换占位符值，请务必提供示例属性来说明预期用途。 +

+ +

+ 以下是其他一些占位符标记的示例； +

+ +
+<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
+
+<!-- 特殊 Unicode 符号的占位符示例 -->
+
+<string name="star_rating">Check out our 5
+
+    <xliff:g id="star">\u2605</xliff:g>
+
+</string>
+
+<!-- 网址的占位符示例 -->
+
+<string name="app_homeurl">
+
+    Visit us at <xliff:g id="application_homepage">http://my/app/home.html</xliff:g>
+
+</string>
+
+<!-- 名称的占位符示例 -->
+
+<string name="prod_name">
+
+    Learn more at <xliff:g id="prod_gamegroup">Game Group</xliff:g>
+
+</string>
+
+<!-- 实值的占位符示例 -->
+
+<string name="promo_message">
+
+    Please use the "<xliff:g id="promotion_code">ABCDEFG</xliff:g>” to get a discount.
+
+</string>
+
+...
+
+</resources>
+
+ + +

相关资源

+ +
+
+ +
+

+ 4. 翻译界面字符串和其他资源 +

+ + +
+ +

+ 将应用的界面字符串和资源翻译为目标语言是本地化过程中的关键阶段，需要给予最多关注并做出规划。 +

+ +

+ 我们建议你与专业翻译人员合作（请参阅聘请专业翻译公司），以确保获得高品质的翻译，提升应用的价值。你也可以选择机器翻译，但用户体验不如人工翻译。 +

+ +

+ 准备翻译 +

+ +

+ 翻译工作的质量在一定程度上取决于你为翻译提供的源资料，因此请确保你的 strings.xml 文件条理清晰、注释完善，而且完全准确。 +

+ +

+ 以下是一些在翻译之前准备字符串的方法： +

+ + + +

+ 发送字符串进行翻译 +

+ +

+ 在开发阶段的初期，你就可以与专业的翻译供应商联系，商定费用和周转时间，而且你的费用应该包含多次反复工作的费用。你可以寻找在线翻译供应商或直接使用 Google Play 开发者控制台提供的翻译服务（请参阅聘请专业翻译公司）。 +

+ +

+ 翻译完成后，请进行初步检查。查看所有文件是否均已翻译，是否存在潜在编码问题，并确保声明格式未被破坏。 +

+ +

+ 如果一切正常，请小心地将已本地化的目录和文件移回应用的资源中。请务必使用正确的语言和语言区域限定符标记目录，以便以后能够正确加载这些目录。 +

+ +

+ 在将翻译合并到你的应用之后，请开始测试已本地化的应用。 +

+ +

+ 通过 Google Play 聘请专业翻译公司 +

+ +

+ Google Play 应用翻译服务可以帮助你为应用快速寻找和购买翻译服务。在开发者控制台中，你可以浏览已由 Google 认证的第三方供应商列表，这些供应商能够以有竞争力的价格为你提供高品质的翻译。你可以上传要翻译的字符串，选择翻译的目标语言，并根据时间和价格选择翻译供应商。 +

+ +

+ 购买翻译之后，你会收到来自供应商的电子邮件。这是你与供应商之间的直接业务往来，你需要直接与供应商合作，管理翻译流程并解决所有支持问题。 +

+ +
+ +
+ +

相关资源

+ +
+
+ +
+

+ 5. 测试已本地化的应用 +

+ + +
+ +

+ 收到翻译的字符串和资源并放入应用之后，你需要对应用进行测试，确保应用能够向国际用户发布。 +

+ +

+ 人工测试可以帮助你发现布局和字符串中的本地化问题，这些问题可能影响用户满意度，最终影响应用的用户评分。 +

+ +

+ 设置测试环境 +

+ +

+ 要测试已本地化的应用，你需要根据你的目标市场和适配设备，设置包含多种设备（或虚拟设备）和屏幕尺寸的测试环境。请注意，不同地区可用的设备可能不同。如果可能，请将你的测试设备设置为用户能够使用的实际设备。 +

+ +

+ 查找常见的本地化问题 +

+ +

+ 在每台测试设备上，在“设置”中设定语言或语言区域。安装并启动应用，然后浏览所有界面流程、对话框和用户互动。在需要输入内容的部分输入文本。要查找的内容包括： +

+ + + +

+ 如果翻译后的字符串变得过于臃肿，不能适应布局，建议你尝试简化默认文本、简化译文文本或调整默认布局。如果问题仍然不能解决，请为该语言创建自定义布局。 +

+ +

+ 测试默认资源 +

+ +

+ 使用所有目标语言和语言区域测试应用之后，请务必使用不支持的语言和语言区域再次测试。这有助于确保你的应用包括完整的默认字符串和资源，可供所有用户使用，不论用户设置了哪种首选语言。 +

+ +

+ 邀请母语使用者进行复查 +

+ +

+ 在测试过程中或之后，建议你邀请相应的母语使用者对本地化的应用进行复查。一种方法是让目标地区的用户进行 Beta 版测试，Google Play 可以帮助你开展这项工作。

+ + +
+

+ 6. 准备国际化发布 +

+ + +
+ +

+ 翻译应用是本地化过程中的关键部分，但是要让你的产品吸引用户、获得关注，你应该做好在目标国家/地区发布应用的准备，并针对国际用户制定更广泛的发布和营销计划。 +

+ +

+ 本地化你的 Google Play 商品详情 +

+ +
+
+

+ 本地化你的 Google Play 商品详情 +

+ +

+ Google Play 商店的商品详情是国际用户对你应用的第一印象。你应该向所有用户重点介绍应用的优势！在开发者控制台中本地化商品详情时，需要本地化的内容包括：

+ +
    +
  • 应用标题和说明 +
    • + +
  • 应用在手机和平板电脑上的屏幕截图 +
    • + +
  • 宣传图片和视频 +
    • +
+
+
+ +

+ 如果你想让应用在国际市场中取得成功，则务必要本地化你的 Google Play 商品详情。你可以在开发者控制台中管理已本地化的商品详情。 +

+ +

+ 在发布之前，请决定你的应用标题、说明、宣传文字、营销主题和计划以及其他文字和图片。请提早发送你的商品详情文字和图片进行翻译，确保这些内容在 Beta 版测试开始时就准备就绪。收到译文后，你可以通过开发者控制台添加译文。 +

+ +
+
+

+ Google Play 中的商品详情翻译 +

+ +

+ 你可以使用 Google Play 上的应用翻译服务翻译你的商品详情。准备包含商品详情信息的 XML 文件，并像上传 strings.xml 文件一样上传此文件（请参阅聘请专业翻译公司） +

+
+
+ +

+ 另外，你已经创建了优秀的本地化应用，那么就应该让用户知晓。截取各个语言版本的界面在手机和平板电脑（7 英寸和 10 英寸）上的截图。你可以将所有目标语言版本的屏幕截图上传到开发者控制台。这对于使用其他语言浏览你的应用商品详情的用户来说有很重要的参考价值。 +

+ +

+ 你还有必要准备本地化版本的宣传图片和视频。例如，你应用的置顶大图可能包括应该翻译的文字，翻译之后能达到最佳效果，或者你可能希望在某个国家/地区呈现与众不同的视觉效果。你可以为每种目标语言创建相应版本的宣传图片，并将它们上传到开发者控制台。如果你提供宣传视频，则可以创建本地化版本的视频，然后添加指向各目标语言版本的视频的链接。 +

+ +

+ 在主要国家/地区计划 Beta 版的发布 +

+ +
+
+

+ 简单的 Beta 测试 +

+ +

+ 现在，Google Play 允许你在世界范围内设立 Alpha 版和 Beta 版测试者小组。下次登录到开发者控制台时请别忘记了解这一强大的功能。 +

+
+
+ +

+ 在发布应用之前收集用户的真实反馈是很有必要的做法，特别是使用新的语言、在新的国家或地区发布应用时，应该收集更多反馈。在这种情况下，我们强烈建议你向主要目标市场的用户发布应用的预览版本，以便这些用户能够方便地向你提供反馈和报告错误。 +

+ +

+ Google Play 可以帮助你为应用设置 Beta 测试计划。登录到开发者控制台并上传你的 APK 之后，你可以设立用户小组，以便进行应用的 Alpha 版和 Beta 版测试。你可以先进行小范围的 Alpha 版测试，然后推进到更大范围的 Beta 版测试。 +

+ +

+ 用户被添加到小组之后，他们可以访问你应用的商品详情并安装应用。Alpha 或 Beta 版本的用户不能留下评论或评分，因此你在 Google Play 上的评分不会受到不利影响，不过这意味着你需要为测试者设置一种机制以便他们提供反馈：不妨创建一个 Google+ 页面或 Google 网上论坛。 +

+ +

+ 收到的反馈可以帮助你调整界面、翻译和商品详情，以确保为用户提供优质体验。 +

+ +

+ 计划国际化营销 +

+ +

+ 为了在更多国家/地区获得最高的关注度，请考虑制定国际化营销或广告计划。计划的覆盖范围取决于你能支持的预算，但一般来说，在发布时和发布后针对特定国家/地区开展营销是经济、高效的措施。 +

+ +

+ 创建本地化的 Google Play 徽章 +

+ +

+ 如果你正在准备国际化营销，请务必加入本地化的 Google Play 徽章，让用户知道你是在 Google Play 上发布应用的。你可以使用徽章生成器快速构建本地化的徽章，然后用到你的网站或营销材料中。你还可以获得高分辨率的资源。 +

+ +

+ 创建本地化的 Device Art +

+ +

+ 如果你有应用在 Android 设备上运行的产品截图，请确保这些截图拥有精美外观，能够反映应用在 Android 设备上的最新状态。为帮助你准备高品质的营销材料，请使用 Device Art Generator，只需拖放即可快速获得在 Nexus 设备上的屏幕截图。 +

+ +

+ 查看你的优化提示 +

+ +

+ 在准备发布时，请务必登录到开发者控制台，查看为你的应用提供的“优化提示”。通过优化提示，你可以了解本地化的商品详情是否有所遗漏，还可以获得其他有用的提示，帮助你实现成功的本地化发布。 +

+ +

相关资源

+ +
+
+ +
+

+ 7. 在发布后为国际用户提供支持 +

+ + +
+ +

+ 在国际范围内发布应用之后，你应该准备好为各种语言和时区的用户提供支持。能为国际用户提供什么样的支持取决于你的预算，不过你至少要在发布后认真查看应用获得的评分、评论和下载统计信息。 +

+ +

+ 以下是一些建议： +

+ + + +

+ 按照这里介绍的做法本地化你的应用、向国际用户宣传和营销你的应用，并为用户提供持续的支持，你的应用就能吸引很多新用户并始终赢得他们的青睐。 +

+ +

+ 请务必阅读发布检查清单，以详细了解如何在 Google Play 上计划、构建和发布你的应用。 +

+

相关资源

+ +
diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/promote/badges.jd b/docs/html-intl/intl/zh-cn/distribute/tools/promote/badges.jd new file mode 100644 index 0000000000000..1c8216136cdaf --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/promote/badges.jd @@ -0,0 +1,278 @@ +page.title=Google Play 徽章生成器 +page.image=/images/gp-badges-set.png +page.metaDescription=点击几下就可以为你的应用程序构建徽章，或者下载为各种语言本地化的高分辨率徽章资产。 + +@jd:body + +

借助 Google Play 徽章，你可以在在线广告、宣传材料或任何提供应用链接的地方使用 Google 的官方品牌标识，向大众推广你的应用。

+ +

请在下面的表单中输入你应用的应用包名称或发布者名称，选择徽章样式，点击“制作我的徽章”，然后将 HTML 代码粘贴至你的网页内容中。

+ +

如果你要为应用创建宣传网页，则还应使用 Device Art Generator，以方便快捷地将应用截图嵌入到设备效果图中。

+ +

有关 Google Play 徽章及其他品牌资源的使用指南，请参阅品牌指南。

+ + + + + +
+ + +

 

+ +   + 清除 +

 或

+ +   + 清除 +

+ + +
+ + +      + + +
+ +
+ + +      + + +
+ + +
+
+ +
+

请复制以下 HTML 代码并将其粘贴到你的网站上：

+ + +

试试以下内容：

+
+
+ diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/promote/brand.jd b/docs/html-intl/intl/zh-cn/distribute/tools/promote/brand.jd new file mode 100644 index 0000000000000..065673ee5cb77 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/promote/brand.jd @@ -0,0 +1,148 @@ +page.title=品牌指南 +page.image=/assets/images/resource-card-default-android.jpg +page.metaDescription=关于Android 和 Goolge Play 品牌的指南和下载。 + +@jd:body + +

我们建议你在 Android 应用的宣传资料中使用 Android 和 Google Play 品牌。只要你遵循相关指南，就可以使用本页中的图标和其他资源。

+ +

对 Android 或 Google Play 品牌的使用必须经过 Android 合作伙伴营销小组的审核。请使用 Android 和 Google Play 品牌权限咨询表单提交你的营销资料以供审核。

+ +

Android

+ +

以下是关于 Android 品牌和相关资源的指南。

+ + +

在文本中使用 Android

+ +
+ +
+ + +

每次使用 Android 名称时，你的资料中都应注明以下归属信息：

+
Android 是 Google Inc. 的商标。
+ + +

Android 机器人

+ +
+ +

+ 100x118 | + 200x237
+ Illustrator 文件 (.ai)

+
+ +

你可以在营销资料中随意使用、复制和修改 Android 机器人。对于印刷版本，Android 机器人的颜色值为 PMS 376C；对于在线版本，请使用十六进制颜色 #A4C639。

+ +

在使用 Android 机器人或其变体形式时，请遵循知识共享署名 3.0 许可的条款使用正确的归属信息：

+ +
Android 机器人是在 Google 原创及共享成果的基础上再创作或修改而成，须遵照知识共享署名 3.0 许可所述条款付诸应用。
+ +

你不得通过将 Android 机器人徽标或其变体形式加入自己的公司徽标或商家名称，来提出商标申请。我们希望确保 Android 机器人可供所有人使用。

+ + +

Android 徽标

+ +
+ +
+ +

不得使用 Android 徽标。

+ +

不得使用 Android 徽标专用的字体。

+ +

Google Play

+ + +

以下是关于 Google Play 品牌和相关资源的指南。

+ +

在文本中使用 Google Play

+ +

在文本中，请务必为首次出现或位于显著位置的 Google Play™ 加上 TM 符号。

+ +

在提及移动设备体验时，除非相应文本中是很明显的说明性内容，否则请使用“Google Play”。例如，营销资料的标题可以是“从 Google Play™ 下载我们的游戏”，但是说明性内容可以是“使用 Google Play™ 商店应用下载我们的游戏”。 + +

每次使用 Google Play 名称或图标时，你的资料中都应注明以下归属信息：

+ +
Google Play 是 Google Inc. 的商标。
+ + +
+ +

+ 48x48 | + 96x96
+ 600x576 +

+
+ +

Google Play 商店图标

+ +

你可以使用 Google Play 商店图标，但不得修改它。

+ +

如上文所述，在文案中提及 Google Play 商店应用时，请使用全称：“Google Play 商店”。但直接标注 Google Play 商店图标时，可以只使用“Play 商店”，以便与设备上显示的图标标签一致。

+ + +

Google Play 徽章

+ +
+ +

+ 129x45 | + 172x60

+
+ +
+ +

+ 129x45 | + 172x60

+
+ +

你可以在网站和宣传资料中使用“即刻获取 Google Play”和“即刻获取 Android 应用 Google Play”徽标作为徽章，以指向你在 Google Play 上的商品。你也可以使用其他 Google Play 徽章格式，以及用于音乐、图书、杂志、电影和电视节目的徽章。要申请这些徽章，请使用 Android 和 Google Play 品牌权限咨询表单。

+ + + +

要快速创建链接至你在 Google Play 上的应用的徽章，请使用 Google Play 徽章生成器（支持 40 多种语言）。

+ +

要创建自定义尺寸的徽章，请下载支持 40 多种语言的 Google Play 徽章的 Adobe® Illustrator® (.ai) 文件。

+ +

要详细了解如何链接至 Google Play 中的商品详情页，请参阅链接至你的商品。

+ +

营销审核和品牌咨询

+ +

请使用 Android 和 Google Play 品牌权限咨询表单提交相关的营销审核或品牌咨询。一般情况下，我们至少需要一周时间才能做出回复。

+ +

diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/promote/device-art.jd b/docs/html-intl/intl/zh-cn/distribute/tools/promote/device-art.jd new file mode 100644 index 0000000000000..b6517b356d3d9 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/promote/device-art.jd @@ -0,0 +1,675 @@ +page.title=Device Art Generator +page.image=/images/device-art-ex-crop.jpg +page.metaDescription=为了更好看的宣传图片和改善视觉语境，拖放你的应用程序的屏幕截图到真实设备的图稿。 + +@jd:body + +

你可以使用 Device Art Generator 方便快捷地将应用截图嵌入到真实设备的效果图中。这样，当用户在你的网站上或其他宣传材料中看到你的应用截图时，就能更加直观地了解应用的内容环境

+ +

注意：请勿将此处生成的图片用作 Google Play 应用商品详情中的 1024x500 置顶大图或屏幕截图

+ + + +
+ +
+
+

第 1 步

+

将屏幕截图从桌面拖动到右侧的设备上生成效果图。

+
+
+
    + 旧款设备 +
      +
      +
      + + + +
      +
      +

      第 2 步

      +

      你可以对此效果图进行优化，然后将其拖动到桌面上保存。

      +

      + +
      + +

      + 旋转 +

      +
      +
      + +
      无输入图片。
      +
      +
      + +
      + + + + + diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd b/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd new file mode 100644 index 0000000000000..c7cf7cf700b17 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd @@ -0,0 +1,186 @@ +page.title=链接到你的商品 +page.image=/images/gp-linking-ex-crop.png +page.metaDescription=了解如何构建链接，把用户从浏览或搜索带到你在 Google Play 的应用程序。 + +@jd:body + +
      +
      + + 即刻获取 Google Play + +

      如需获得内含 Google Play 品牌图标的链接，请访问徽章页面。

      +
      +
      + +

      Google Play 提供多种链接格式，可让你按自己需要的方式将用户从 Android 应用、网页、广告、评论、文章、社交媒体帖子等链接到你的商品。

      + +

      这些链接格式可让你：

      + + +

      如果你从 Android 应用上提供链接，还可以控制此链接是启动 Play 商店应用还是启动浏览器，后者会将用户转至 Google Play 网站。

      + +

      链接到商品详情页

      + +

      如果提供下面这种格式的深层链接，你可以将用户直接指向特定应用的商品详情页。在商品详情页上，用户可以查看应用的说明、屏幕截图以及评论等，还可以安装该应用。

      + +

      要创建此链接，你需要提供完全符合要求的“程序包名称”（可在相应应用的AndroidManifest.xml中找到）。此外，程序包名称还会显示在开发者控制台中。

      + +
      +
      从网站上：
      +
      + 
      http://play.google.com/store/apps/details?id=<package_name>
      +
      +
      从 Android 应用上：
      +
      + 
      market://details?id=<package_name>
      +
      +
      + +

      示例如下：

      + +

      http://play.google.com/store/apps/details?id=com.google.android.apps.maps

      + +

      要详细了解如何在 Android 应用中发送链接，请参阅从 Android 应用提供链接。

      + + + +

      链接到商品列表

      + +

      如果提供下面这种格式的链接，你可以将用户指向你所发布应用的列表。通过商品列表，用户可以查看特定发布者提供的所有应用，以及各个应用的评分、编辑徽章和“安装”按钮。

      + +

      要创建此链接，你需要提供“发布者名称”（可在开发者控制台中找到）。

      + +
      +
      从网站上：
      +
      + 
      http://play.google.com/store/search?q=pub:<publisher_name>
      +
      +
      从 Android 应用上：
      +
      + 
      market://search?q=pub:<publisher_name>
      +
      +
      + +

      示例如下：

      + +

      http://play.google.com/store/search?q=pub:Google Inc.

      + +

      要详细了解如何在 Android 应用中发送链接，请参阅从 Android 应用提供链接。

      + + +

      链接到搜索结果

      + +

      如果提供下面这种格式的链接，你可以将用户指向 Google Play 上的搜索查询结果页。搜索结果页会显示与此次查询相匹配的应用的列表（可能还会显示其他内容），以及各个应用的评分、徽章和“安装”按钮。

      + +

      要创建此链接，你只需提供一个搜索查询字符串。如果你希望此次查询搜索 Google Play 应用商品详情以外的地方，则可以去掉该链接网址中的 &c=apps 部分。

      + +
      +
      从网站上：
      +
      + 
      http://play.google.com/store/search?q=<search_query>&c=apps
      +
      +
      从 Android 应用上：
      +
      + 
      market://search?q=<seach_query>&c=apps
      +
      +
      + +

      示例如下：

      + +

      http://play.google.com/store/search?q=maps&c=apps

      + +

      要详细了解如何在 Android 应用中发送链接，请参阅从 Android 应用提供链接。

      + + + +

      链接到某个合集

      + +

      如果你的应用获得推荐或显示在某个 Google Play 排行榜或合集中，你可以提供下面这种格式的链接，将用户直接指向相应合集。该合集会按照一定顺序排列显示其中的应用，并会显示各个应用的评分、简短说明和“安装”按钮。

      + +
      +
      从网站上：
      +
      + 
      http://play.google.com/store/apps/collection/<collection_name>
      +
      +
      从 Android 应用上：
      +
      + 
      market://apps/collection/<collection_name>
      +
      +
      + +

      示例如下：

      + +

      http://play.google.com/store/apps/collection/editors_choice

      + +

      要详细了解如何在 Android 应用中发送链接，请参阅从 Android 应用提供链接。

      + +

      表 1： Google Play 上的合集

      + + + + + + + + + + + + + + +
      合集collection_name
      店员推荐（精选）featured
      编辑精选editors_choice
      热门付费topselling_paid
      热门免费topselling_free
      热门免费新品topselling_new_free
      热门付费新品topselling_new_paid
      创收最高topgrossing
      上升最快movers_shakers
      最畅销游戏topselling_paid_game
      + + +

      从 Android 应用提供链接

      + +

      用户在 Android 设备上可以访问两种常规格式的链接。这两种格式在设备上触发的行为略有不同：

      + + + +

      一般情况下，你应对网页上的链接使用 http:// 格式；对 Android 应用中的链接使用 market://。

      + +

      如果你希望用户从 Android 应用链接到你的商品，请创建一个可打开 Google Play 网址的 Intent，如下例所示。

      + + 
      +	Intent intent = new Intent(Intent.ACTION_VIEW);
+	intent.setData(Uri.parse("market://details?id=com.example.android"));
+	startActivity(intent);
+
      + + +

      网址格式总结

      + +

      下表总结了 Google Play 当前支持的 URI（在网页上和在 Android 应用中），如前几部分所述。

      + + + + + + + + + + + + + + + + + + + + + +
      结果网页链接Android 应用链接
      显示特定应用的商品详情页http://play.google.com/store/apps/details?id=<package_name> + market://details?id=<package_name>
      显示特定发布者的应用http://play.google.com/store/search?q=pub:<publisher_name>market://search?q=pub:<publisher_name>
      使用常规字符串查询搜索应用http://play.google.com/store/search?q=<query>market://search?q=<query>
      diff --git a/docs/html-intl/intl/zh-cn/google/play/billing/api.jd b/docs/html-intl/intl/zh-cn/google/play/billing/api.jd new file mode 100644 index 0000000000000..fbdbac6c28433 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/google/play/billing/api.jd @@ -0,0 +1,117 @@ +page.title=应用内结算 API +parent.title=In-app Billing +parent.link=index.html +@jd:body + + + +

      借助应用内结算 API 第 3 版，您可以更轻松地将应用内结算功能集成到自己的应用中。此版本包括下列功能：经过改进的同步购买流程、可让您轻松跟踪消耗型商品所有权的 API 以及在本地缓存应用内购买数据。

      + +

      商品类型

      +

      您可以使用 Google Play 开发者控制台来定义您的商品，包括商品类型、SKU、价格和说明等等。有关详情，请参阅管理应用内结算。API 第 3 版支持两种商品类型，即托管的应用内商品和订阅。

      +

      托管的应用内商品

      +

      托管的应用内商品是指由 Google Play 跟踪和管理其所有权信息的商品。当用户购买托管的应用内商品时，Google Play 会针对每位用户分别存储各商品的购买信息。这使得您日后可随时向 Google Play 进行查询，恢复特定用户购买的商品的状态。这类信息会永久保存在 Google Play 服务器上，即使用户卸载应用或更换设备也是如此。

      +

      如果您使用的是 API 第 3 版，还可以在应用内消耗托管的商品。通常情况下，您可以对那些可供多次购买的商品（例如游戏中使用的货币、燃料或魔法药）实施消耗。托管的商品在被购买后，必须先向 Google Play 发送消耗请求进行消耗，然后才能供用户再次购买。要详细了解应用内商品的消耗，请参阅消耗商品

      + +

      订阅

      +

      订阅是应用内结算中提供的一种商品类型，可让您通过按月或按年结算的方式在应用内向用户销售内容、服务或功能。您可以在各类应用或游戏中销售对几乎所有类型的数字内容的订阅。要了解订阅的工作原理，请参阅应用内结算订阅。

      +

      使用 API 第 3 版，您可以使用与应用内商品相同的购买流程来购买订阅和检索订阅购买信息。有关代码示例，请参阅实施订阅。

      +

      重要提示：与应用内商品不同，订阅无法消耗。

      + +

      购买商品

      + +
      + +

      + 图 1. 购买请求的基本顺序。 +

      +
      + +

      API 第 3 版中的典型购买流程如下所示： +

        +
      1. 您的应用向 Google Play 发送 isBillingSupported 请求，以确定您当前使用的应用内结算 API 目标版本是否受支持。
        2. +
      2. 当您的应用启动或用户登录时，最好向 Google Play 进行查询，确定该用户拥有哪些商品。要查询用户的应用内购买，请发送 getPurchases 请求。如果该请求成功，Google Play 会返回一个 Bundle，其中包含所购商品的商品 ID 列表、各项购买详情的列表以及购买签名的列表。
        3. +
      3. 通常情况下，您需要通知用户商品是否可供购买。要查询您在 Google Play 中定义的应用内商品的详细信息，应用可以发送 getSkuDetails 请求。您必须在该查询请求中指定商品 ID 列表。如果该请求成功，Google Play 会返回一个包含产品详情（包括商品的价格、标题、说明和购买类型）的 Bundle。 +
        4. +
      4. 如果该用户还未拥有应用内商品，您可以提示购买。为了发起购买请求，您的应用会发送 getBuyIntent 请求，指定要购买商品的商品 ID 以及其他参数。当您在开发者控制台中创建新的应用内商品时，应记录其商品 ID。 +
          +
        1. Google Play 返回的 Bundle 中包含 PendingIntent，您的应用可用它来启动购买结帐界面。
          2. +
        2. 您的应用通过调用 startIntentSenderForResult 方法来启动 PendingIntent。
          3. +
        3. 当结帐流程结束后（即用户成功购买商品或取消购买），Google Play 会向您的 onActivityResult 方法发送响应 Intent。onActivityResult 的结果代码中有一个代码将用于表明用户是完成了购买还是取消了购买。响应 Intent 中会包含所购商品的相关信息，其中包括 Google Play 为了唯一标识此次购买交易而生成的 purchaseToken 字符串。Intent 中还包含使用您的私人开发者密钥签署的购买签名。
          4. +
        +
        5. +
      +

      +

      要详细了解 API 第 3 版的调用和服务器响应，请参阅应用内结算参考。

      + +

      消耗应用内商品

      +

      您可以使用消耗机制来跟踪用户对应用内商品的所有权。

      +

      在第 3 版中，所有应用内商品都是托管的。也就是说，用户对所购应用内商品的所有权由 Google Play 进行维护，您的应用可以在需要时查询用户的购买信息。当用户成功购买应用内商品后，该次购买就会记录在 Google Play 中。应用内商品一经售出，就会被视为“被拥有”。处于“被拥有”状态的应用内商品无法再通过 Google Play 购买。您必须对“被拥有”的应用内商品发送消耗请求，然后 Google Play 才能再次将其设成可购买状态。消耗应用内商品会将商品切换回“未被拥有”状态并删除之前的购买数据。

      +
      + +

      + 图 2. 消耗请求的基本顺序。 +

      +
      +

      为了检索用户所拥有商品的列表，您的应用会向 Google Play 发送 getPurchases 调用。您的应用可以通过发送 consumePurchase 调用提出消耗请求。在请求参数中，您必须指定应用内商品独一无二的 purchaseToken 字符串，此字符串是在商品售出时由 Google Play 指定的。Google Play 会返回一个状态代码，指明此次消耗是否已成功记录。

      + +

      非消耗型和消耗型应用内商品

      +

      您需要决定您的应用内商品是非消耗型商品还是消耗型商品。

      +
      +
      非消耗型商品
      +
      通常情况下，对于在应用内购买一次就能永久使用的应用内商品，您无需实施消耗。这些商品在购买后将永久与用户的 Google 帐户相关联。高级版升级和关卡包就属于非消耗型应用内商品。
      +
      消耗型商品
      +
      相反，对于可多次购买的商品，您可以实施消耗。通常情况下，这类商品提供某些临时效果。例如，用户在游戏中的角色可以从自己的存货中获得生命值或额外的金币。在您的应用中分配所购商品的收益或效果称之为“配置”应用内商品。您负责控制和跟踪如何向用户配置应用内商品。 +

      重要提示：您必须先向 Google Play 发送消耗请求，在收到表明此次消耗已成功记录的响应之后，您才能在应用中配置消耗型应用内商品。

      +
      +
      +

      在应用中管理消耗型商品购买

      +

      下面是购买消耗型应用内商品的基本流程：

      +
        +
      1. 调用 getBuyIntent 启动购买流程。
        2. +
      2. 从 Google Play 接收指示购买是否成功完成的响应 Bundle。
        3. +
      3. 如果购买成功，通过调用 consumePurchase 消耗此次购买。
        4. +
      4. 从 Google Play 接收指示消耗是否成功完成的响应代码。
        5. +
      5. 如果消耗成功，在应用中配置商品。
        6. +
      +

      之后，当用户启动或登录到您的应用时，您应检查该用户是否拥有任何尚未消耗的消耗型应用内商品。如果有，请务必消耗并配置这些商品。如果您在应用中实施消耗型应用内商品，则可以采用以下推荐的应用启动流程：

      +
        +
      1. 发送 getPurchases 请求，查询该用户拥有的应用内商品。
        2. +
      2. 如果有消耗型应用内商品，通过调用 consumePurchase 消耗这些商品。必须执行这步操作，因为应用虽可能已完成该消耗型商品的购买订单，但在其发送消耗请求之前仍有可能停止运行或断开连接。
        3. +
      3. 从 Google Play 接收指示消耗是否成功完成的响应代码。
        4. +
      4. 如果消耗成功，在应用中配置商品。
        5. +
      + +

      本地缓存

      +

      目前，由于 Google Play 客户端在设备上本地缓存应用内结算信息，因此您可以使用 API 第 3 版更频繁地查询此类信息，例如通过调用 getPurchases 进行查询。与旧版本的 API 不同，API 第 3 版的很多调用都是在缓存中进行查找，而不用通过网络连接到 Google Play，这样就显著加快了 API 的响应速度。

      diff --git a/docs/html-intl/intl/zh-cn/google/play/billing/billing_admin.jd b/docs/html-intl/intl/zh-cn/google/play/billing/billing_admin.jd new file mode 100644 index 0000000000000..989c0e7d59a2f --- /dev/null +++ b/docs/html-intl/intl/zh-cn/google/play/billing/billing_admin.jd @@ -0,0 +1,364 @@ +page.title=管理应用内结算 +parent.title=In-app Billing +parent.link=index.html +@jd:body + + + +

      如果您使用应用内结算，您就无需处理任何财务交易。不过，您仍需执行一些管理任务，包括在 Google Play 开发者控制台上创建和维护您的商品列表、注册测试帐户以及在需要时处理退款。

      + +

      您必须有 Google Play 发布商帐户才能注册测试帐户。而且，您必须有 Google 电子钱包商家帐户才能创建商品列表以及向用户发放退款。如果您已有 Google Play 发布商帐户，则可以使用您的现有帐户，无需注册新帐户就能使用应用内结算。

      + +

      如果您没有发布商帐户，可以在 Google Play 开发者控制台中以 Google Play 开发者的身份注册设置一个发布商帐户。如果您没有 Google 电子钱包商家帐户，也可以通过开发者控制台注册一个。

      + +

      创建商品列表

      + +

      Google Play 开发者控制台为您发布的每个应用都提供一份商品列表。您可以使用 Google Play 的应用内结算功能销售商品，但前提是该商品已在应用的商品列表中列出。每个应用都有自己的商品列表，您不能在某个应用中销售其他应用的商品列表中列出的商品。

      + +

      您可以点击开发者帐户中列出的应用内的应用内商品链接，访问该应用的商品列表（参见图 1）。只有当您拥有 Google 电子钱包商家帐户且该应用的清单中包含 com.android.vending.BILLING 权限时，应用内商品链接才会显示。

      + +

      商品列表列出了您在应用内销售的商品（应用内商品、订阅内容或两者的组合）。对于每件商品，商品列表中都会包含商品 ID、商品说明和价格等信息。商品列表只存储应用内所售商品的相关元数据，而不会存储任何数字内容。应用内销售的数字内容的存储和发送是由您负责的。

      + +
      + +

      + 图 1. 您可以点击“应用”主导航面板中的应用内商品链接，访问应用的商品列表。 +

      +
      + +

      您可以为所有已发布的应用或者 Alpha 或 Beta 渠道中的所有应用（这些应用上传并保存到开发者控制台）创建商品列表。不过，您必须有 Google 电子钱包商家帐户且该应用的清单中必须包含 com.android.vending.BILLING 权限。如果应用的清单中未包含此权限，您只能在商品列表中修改现有商品但不能向该列表添加新商品。要详细了解此权限，请参阅更新您应用的清单。

      + +

      注意：过去，您可以通过上传未发布的“草稿”版本来测试应用，但现在系统已不再支持此功能。因此，您必须将应用发布到 Alpha 或 Beta 分发渠道，才能进行测试。有关详情，请参阅草稿应用不再受支持。 + +

      此外，一个应用包只能有一个商品列表。如果您为某个应用创建商品列表且使用多 APK 功能为该应用分发多个 APK，那么此商品列表将应用到与该应用商品详情相关联的所有 APK 版本。如果您使用的是多 APK 功能，则无法为各个 APK 创建单独的商品列表。

      + +

      您可以通过两种方式向商品列表添加商品：通过应用内商品界面逐一添加商品（参见图 2）；通过导入逗号分隔值 (CSV) 文件中的商品批量添加商品。如果您的应用只有几件应用内商品或您只是向商品列表添加几件测试商品，那么逐一添加商品这种方法就非常实用。如果您的应用有大量应用内商品，使用 CSV 文件的方法就较为实用。

      + +

      注意：目前系统尚不支持批量上传包含订阅内容的商品列表。

      + +

      向商品列表逐一添加商品

      + +

      要通过应用内商品界面向商品列表添加一件商品，请按以下步骤操作：

      + +
        +
      1. 登录到您的发布商帐户。
        2. +
      2. 在所有应用面板中，点击相应的应用名称，然后选择应用内商品。
        3. +
      3. 点击添加新商品（参见图 2），提供所售商品的详细信息，然后点击保存或发布。
        4. +
      + +
      + +

      + 图 2. 通过“添加新商品”页面，您可以向应用的商品列表添加商品。 +

      +
      + +

      对于商品列表中的每件商品，您都必须输入以下信息：

      + + +
      + +

      + 图 3. 为应用内商品指定其他货币。 +

      +
      + +

      要详细了解商品 ID 和商品列表，请参阅创建应用内商品 ID。要详细了解定价，请参阅应用内结算定价。

      + +

      注意：请务必规划好您的商品 ID 命名空间。商品 ID 保存后就无法再重复使用或更改。

      + +

      向商品列表批量添加商品

      + +

      要使用 CSV 文件向商品列表批量添加商品，您需要先创建 CSV 文件。您在 CSV 文件中指定的数据值与您通过应用内商品界面手动指定的数据值相同（请参阅向商品列表逐一添加商品）。 + +

      如果您通过 CSV 文件导入和导出应用内商品，请记得提供含税价格。如果您使用自动填充，请提供不含税的默认价格，系统会自动填充含税的价格。如果您不使用自动填充，您提供的价格必须是含税价格。

      + +

      注意：目前系统尚不支持批量上传包含订阅内容的商品列表。

      + + CSV 文件使用逗号 (,) 和分号 (;) 来分隔数据值。逗号用来分隔主要数据值，分号用来分隔次要数据值。例如，CSV 文件的语法如下所示：

      + +

      "product_id","publish_state","purchase_type","autotranslate + ","locale; title; description","autofill","country; + price" +

      + +

      相关说明和使用详情如下所示。

      + + + +

      表 1. 您可以在“locale”字段中使用的语言代码。

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      语言代码语言代码
      中文zh_TW意大利语it_IT
      捷克语cs_CZ日语ja_JP
      丹麦语da_DK韩语ko_KR
      荷兰语nl_NL挪威语no_NO
      英语en_US波兰语pl_PL
      法语fr_FR葡萄牙语pt_PT
      芬兰语fi_FI俄语ru_RU
      德语de_DE西班牙语es_ES
      希伯来语iw_IL瑞典语sv_SE
      印地语hi_IN----
      + +

      要导入您在 CSV 文件中指定的商品，请执行以下操作：

      + +
        +
      1. 登录到您的发布商帐户。
        2. +
      2. 在所有应用面板中，点击相应的应用名称，然后选择应用内商品。
        3. +
      3. 在“应用内商品列表”页面上，点击导入/导出 > 从 CSV 文件中导入应用内商品，然后选择 CSV 文件。 +

        CSV 文件必须位于您的本地计算机上或连接到您计算机的本地磁盘上。

        +
        4. +
      4. 如果您想覆盖商品列表中的现有商品，请选中覆盖复选框。 +

        只有当 CSV 文件中的“product_id”值与商品列表中现有商品的应用内商品 ID 一致时，此选项才会覆盖现有商品的值。覆盖功能不会删除商品列表中已列出但不包含在 CSV 文件中的商品。

        +
        5. +
      + +

      您还可以点击“应用内商品列表”页面上的导出为 CSV，将现有商品列表导出为 CSV 文件。如果您已将商品手动添加到商品列表，但现在想开始通过 CSV 文件管理该商品列表，此功能就非常有用。

      + +

      选择商品类型

      + +

      商品的商品类型用来控制 Google Play 如何管理该商品的购买流程。商品类型有以下三种：“按用户帐户管理的商品”、“不受管理的商品”和“订阅内容”。但请注意，不同版本的应用内结算服务支持的商品类型不同，因此务必根据您的应用所用的应用内结算版本，选择合适的商品类型。

      + +

      有关详情，请参阅应用内结算第 3 版或应用内结算第 2 版的相关文档。 + +

      处理退款

      + +

      应用内结算不允许用户向 Google Play 发送退款申请。应用内购买的退款事宜必须直接发送给您（应用开发者）。然后，您可以通过您的 Google 电子钱包商家帐户处理这笔退款。当您处理退款时，Google Play 会收到 Google 电子钱包发来的退款通知，并且 Google Play 会向您的应用发送退款消息。有关详情，请参阅处理 IN_APP_NOTIFY 消息和应用内结算定价。

      + +

      重要提示：您不能使用 Google Wallet API 发放退款或取消应用内结算交易，而是必须通过您的 Google 电子钱包商家帐户手动执行此类操作。不过，您可以使用 Google Wallet API 检索订单信息。

      + +

      使用订单号

      + +

      当用户购买应用内商品时，Google 电子钱包会为此次交易分配一个永久有效且独一无二的订单号。Google Play 在购买流程结束时会向您提供该订单号，作为 PURCHASE_STATE_CHANGED Intent 中的 orderId 字段的值。

      + +

      在您的应用中，您可以使用该订单号作为此次应用内购买交易的通用标识符。购买后，您可以利用该订单号在对帐报表中跟踪此次交易，以及在提供客户支持时使用该订单号。

      + +

      订单号是完全由数字构成的字符串，格式由 Google 电子钱包指定和管理。

      + +

      对于发生在 2012 年 12 月 5 日及以后的交易，Google 电子钱包会分配一个商家订单号（而非 Google 订单号）并将该商家订单号报告为 orderID 的值。示例如下：

      + + 
      "orderId" : "12999556515565155651.5565135565155651"
      + +

      对于发生在 2012 年 12 月 5 日之前的交易，Google Checkout 分配的是 Google 订单号并已将该编号报告为 orderID 的值。下面是使用 Google 订单号的 orderID 的示例：

      + + 
      "orderId" : "556515565155651"
      + +

      设置测试帐户

      + +

      通过 Google Play 开发者控制台，您可以设置一个或多个测试帐户。测试帐户是您在开发者控制台上注册为测试帐户的常规 Google 帐户。测试帐户已获得授权，可从您已上传到 Google Play 开发者控制台但尚未发布的应用中进行应用内购买。

      + +

      您可以使用任意 Google 帐户作为测试帐户。如果您想让多位用户在应用上测试应用内结算但又不想让他们获得您的发布商帐户的登录凭据，测试帐户就非常有用。如果您想拥有并控制测试帐户，可以自行创建帐户，然后将凭据分发给您的开发者或测试者。

      + +

      测试帐户有三条限制：

      + + + +

      要向您的发布商帐户添加测试帐户，请按以下步骤操作：

      + +
        +
      1. 登录到您的发布商帐户。
        2. +
      2. 点击设置图标。
        3. +
      3. 找到“许可测试”面板。
        4. +
      4. 添加您要注册为测试帐户的电子邮件地址，各帐户之间用英文逗号分隔。
        5. +
      5. 点击保存，保存您的个人资料更改。
        6. +
      + +

      获取应用的许可密钥

      + +

      Google Play 开发者控制台为每个应用都提供一个公用的许可密钥。要获取应用的密钥，请按以下步骤操作：

      +
        +
      1. 打开所有应用面板。
        2. +
      2. 点击相应的应用名称，然后选择服务和 API。
        3. +
      3. 向下滚动到此应用的许可密钥字段，找到应用的密钥，如下图所示。
        4. +
      +

      过去，开发者控制台为每个开发者帐户都提供一个公钥。为了将应用迁移到按应用分配的新公钥，开发者控制台将应用专用密钥设置为之前的开发者密钥。这样做可确保依赖于（之前的）开发者密钥的应用能与新公钥兼容。

      + +
      + +

      + 图 4. 您可以在服务和 API 面板中找到各个应用的许可密钥。 +

      +
      + +

      获取相关支持

      + +

      如果您在实施应用内结算时有疑问或遇到问题，请与下表列出的支持资源联系（参见表 2）。将您的问题发布到正确的论坛上，可以更快获得所需支持。

      + +

      表 2. 适用于 Google Play 应用内结算的开发者支持资源

      + + + + + + + + + + + + + + + + + + + + + +
      支持类型资源主题范围
      开发与测试问题Google 网上论坛：android-developers 应用内结算集成问题、有关用户体验的提示、对响应的处理、混淆代码、进程间通信 (IPC)、测试环境设置。
      堆栈溢出：http://stackoverflow.com/questions/tagged/ + android
      结算问题跟踪器结算项目问题跟踪器与应用内结算示例代码直接相关的错误和问题报告。
      + +

      要了解如何向上述所列论坛发帖的一般信息，请参阅“资源”标签中的开发者论坛一文。

      + diff --git a/docs/html-intl/intl/zh-cn/google/play/billing/billing_best_practices.jd b/docs/html-intl/intl/zh-cn/google/play/billing/billing_best_practices.jd new file mode 100644 index 0000000000000..4aff17d46f6f5 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/google/play/billing/billing_best_practices.jd @@ -0,0 +1,81 @@ +page.title=安全性和设计 +parent.title=In-app Billing +parent.link=index.html +@jd:body + + + +

      在设计应用内结算的实施时，请务必遵循本文中介绍的安全性和设计指南。这些指南是推荐的最佳做法，适用于所有使用 Google Play 应用内结算服务的开发者。

      + +

      安全性方面的最佳做法

      + +

      在服务器上执行签名验证任务

      +

      如果可能的话，你应该在远程服务器上（而不是设备上）执行签名验证。在服务器上实施验证过程，可有效防止攻击者通过对 .apk 文件进行反向工程来破坏验证过程。如果你将安全性流程放置到远程服务器上，请确保设备服务器的握手过程是安全的。

      + +

      保护你的未锁定内容

      +

      为防止恶意用户重新分发你未锁定的内容，请不要将这种内容放入你的 .apk 文件中，而是执行以下操作之一：

      + +

      当你通过远程服务器或实时服务发送内容时，你可以将未锁定内容存储在设备内存中或设备的 SD 卡上。如果你将内容存储在 SD 卡上，请务必将内容加密并使用设备专有的密钥。

      + +

      混淆你的代码

      +

      你应混淆应用内结算代码，让攻击者难以对你的安全协议和其他应用组件进行反向工程。我们建议你至少对代码运行 Proguard 等代码混淆工具。

      +

      除了运行代码混淆程序以外，我们还建议你使用以下技术混淆你的应用内结算代码。

      + +

      使用这些技术有助于缩小你应用的受攻击范围，并最大程度帮助你抵御会对应用内结算实施造成损害的攻击。

      +
      +

      注意：如果你使用 Proguard 来对代码进行混淆处理，则必须将以下内容行添加到 Proguard 配置文件中：

      +

      -keep class com.android.vending.billing.**

      +
      + +

      修改所有示例应用代码

      +

      应用内结算示例是可供任何人下载的公开发布应用。这意味着如果你直接使用发布的示例代码，则对攻击者而言比较容易对你的应用进行反向工程。请紧记示例应用只能作为示例使用。如果你使用示例应用中的任何一部分，则必须在发布之前或将其作为生产应用的一部分前对其进行修改。

      +

      尤其要注意的是，攻击者会寻找应用内已知的进入点和离开点，因此请务必修改与示例应用完全相同的代码部分。

      + +

      使用安全随机数

      +

      随机数必须是不可预测的，也不能重复使用。在生成随机数时，请务必使用采用加密保护的随机数字生成器（例如 SecureRandom），这样可以减少重放攻击。

      +

      此外，如果你在服务器上执行随机数验证，请务必在服务器上生成随机数。

      + +

      在提交购买请求时设置开发者有效内容字符串

      +

      使用应用内结算 API 第 3 版，你可以在向 Google Play 发送购买请求时包括一个“开发者有效内容”字符串令牌。通常情况下，这样做是为了提交可唯一标识此购买请求的字符串令牌。如果你指定字符串值，那么 Google Play 会返回购买响应以及该字符串。随后，在你针对此购买进行查询时，Google Play 会返回此字符串以及购买详情。

      +

      提交字符串令牌可以帮助应用识别进行了购买的用户，以便你稍后验证该用户进行的购买是否合法。对于消耗型商品，你可以使用随机生成的字符串；但是对于非消耗型商品，则应该使用可唯一标识用户的字符串。

      +

      当你获得 Google Play 的响应时，请确保开发者有效内容字符串匹配你之前与购买请求一起发送的令牌。作为进一步的安全预防措施，你应该在自己的安全服务器上执行验证。

      + + +

      针对商标和版权侵权采取行动

      +

      如果你看到自己的内容在 Google Play 上被重新分发，请立即、果断地采取行动。发出商标侵权通知或版权侵权通知。

      + +

      针对未锁定内容实施可撤消方案

      +

      如果你使用远程服务器发送或管理内容，请确保当用户访问内容时，应用能够验证未锁定内容的购买状态。这样你可以根据需要撤消使用，并最大限度地减少盗版。

      + +

      保护你的 Google Play 公钥

      +

      为保护你的公钥安全并防止被恶意用户和黑客攻击，请不要将其作为文字字符串嵌入任何代码中。而是在运行时以拼凑方式构建字符串或者使用位操作处理（例如，XOR 搭配其他字符串）以隐藏真实密钥。公钥本身不是秘密信息，但是你一定不希望黑客或恶意用户能轻易将公钥替换为其他钥匙。

      + diff --git a/docs/html-intl/intl/zh-cn/google/play/billing/billing_overview.jd b/docs/html-intl/intl/zh-cn/google/play/billing/billing_overview.jd new file mode 100644 index 0000000000000..aceadcb373a79 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/google/play/billing/billing_overview.jd @@ -0,0 +1,93 @@ +page.title=应用内结算概述 +parent.title=In-app Billing +parent.link=index.html +@jd:body + +
      +
      +

      概述

      +
        +
      • 使用应用内结算销售数字商品，包括一次性商品和定期订阅。
        • +
      • 在 Google Play 上发布的所有应用均可使用该服务。您只需有 Google Play 开发者控制台帐户和 Google 电子钱包商家帐户即可。
        • +
      • 结帐流程由 Google Play 自动处理，其界面与应用购买流程的界面相同。
        • +
      +

      本文内容

      +
        +
      1. 应用内结算 API
        2. +
      2. 应用内商品 +
          +
        1. 商品类型 +
        +
        3. +
      3. Google Play 开发者控制台
        4. +
      4. Google Play 购买流程
        5. +
      5. 示例应用
        6. +
      6. 迁移注意事项
        7. +
      +

      相关示例

      +
        +
      1. 示例应用（第 3 版）
        2. +
      +
      +
      + +

      本文将介绍您需了解的应用内结算基本组件和功能，以便您将应用内结算功能添加到应用中。

      + +

      注意：请务必遵守目标国家/地区（您要在这些国家/地区分发应用）的适用法律。例如，在欧盟国家，不公平商业行为指令的相关法律禁止直接规劝儿童购买广告产品或者劝说其父母或其他成年人为儿童购买广告产品。请参阅欧盟消费者保护机构的立场，详细了解此主题及其他主题。 +

      + +

      应用内结算 API

      +

      您的应用会通过相应 API （由设备上安装的 Google Play 应用提供）来访问应用内结算服务。然后，Google Play 应用会在您的应用和 Google Play 服务器之间传送结算请求和响应。实际上，您的应用从不直接与 Google Play 服务器通信，而是通过进程间通信 (IPC) 向 Google Play 应用发送结算请求并接收 Google Play 应用发来的响应。此外，您的应用也不管理其与 Google Play 服务器之间的任何网络连接。

      +

      应用内结算只能在您通过 Google Play 发布的应用中实施。要完成应用内购买请求，Google Play 应用必须能够通过网络访问 Google Play 服务器。

      + +

      应用内结算第 3 版是最新版本，依然具有非常广泛的兼容性，可用于各种 Android 设备。运行 Android 2.2 或更高版本且安装了最新版本的 Google Play 商店的设备（绝大多数有效设备）都支持使用应用内结算第 3 版。

      + +

      第 3 版的功能

      + +

      要详细了解应用内结算的其他版本，请参阅版本说明。

      + +

      应用内商品

      +

      应用内商品是您在应用内向用户出售的数字商品，包括游戏代币、旨在改善用户体验的应用功能升级以及应用中的新增内容。

      +

      应用内结算只能用于销售数字内容，而不能用于销售实体商品、个人服务或任何需要进行实物交付的商品/服务。与明码标价的应用不同，一旦用户购买了应用内商品，系统便不会提供退款窗口。

      +

      Google Play 不提供任何形式的内容交付，您需要自行交付在应用内销售的数字内容。应用内商品始终与一个且仅与一个应用明确关联。也就是说，在一个应用中不能购买为另一个应用发布的应用内商品，即使这两个应用来自相同的开发者也是如此。

      + +

      商品类型

      +

      应用内结算支持多种商品类型，因此您可灵活选择如何通过您的应用获利。无论是哪种商品，您均能通过 Google Play 开发者控制台进行定义。

      +

      您可以为应用内结算应用指定以下两类商品：“托管的应用内商品”和“订阅”。Google Play 会按用户帐户来处理和跟踪您应用中的应用内商品和订阅的所有权。详细了解应用内结算第 3 版支持的商品类型。

      + +

      Google Play 开发者控制台

      +

      在开发者控制台上，您不仅能发布应用内结算应用，还能管理您应用中出售的各种应用内商品。

      +

      对于与您的应用相关联的数字商品（包括一次性商品和定期订阅），您可以为其创建商品列表。对于每件商品，您都可以定义下列信息：唯一商品 ID（也称为 SKU）、商品类型、定价、说明以及 Google Play 应如何处理和用户对该商品的购买。

      +

      您还可以创建测试帐户，授权这些帐户测试尚未发布的应用。

      +

      要了解如何使用开发者控制台配置您的应用内商品和商品列表，请参阅管理应用内结算。

      + +

      Google Play 购买流程

      +

      Google Play 使用的结帐后端服务与用于应用购买的服务相同，因此您的用户将获得一致且熟悉的购买流程使用体验。

      +

      重要提示：您必须有 Google 电子钱包商家帐户才能在 Google Play 上使用应用内结算服务。

      +

      购买开始时，您的应用需要针对相应的应用内商品发送结算请求。然后，Google Play 会处理此次交易的所有结帐详情，包括请求和验证付款方式以及处理财务交易。

      +

      当结帐流程完成后，Google Play 会向您的应用发送购买详情，例如订单号、订单日期和时间以及所付价格。您的应用从不需要处理任何财务交易，这些事宜完全 Google Play 负责。

      + +

      示例应用

      +

      为了帮您将应用内结算集成到您的应用中，Android SDK 提供了一个示例应用，向您演示如何在应用内销售应用内商品和订阅。

      + +

      API 第 3 版的 TrivialDrive 示例演示了如何使用应用内结算 API 第 3 版在赛车游戏中实施应用内商品和订阅购买。该应用不仅演示了如何发送应用内结算请求以及处理来自 Google Play 的同步响应，还演示了如何通过此 API 记录商品的消耗情况。第 3 版示例包括多种工具类，非常便于处理应用内结算操作和执行自动签名验证。

      + +

      建议：请务必在发布应用前混淆其中的代码。有关详情，请参阅安全性和设计。

      + +

      迁移注意事项

      +

      应用内结算 API 第 2 版已弃用，将于 2015 年 1 月关闭。如果您现有的应用内结算实施使用的是 API 第 2 版或更低版本，则您必须迁移到应用内结算第 3 版。

      + +

      如果您在发布的应用中销售应用内商品，请注意以下事项：

      + + + + diff --git a/docs/html-intl/intl/zh-cn/google/play/billing/billing_testing.jd b/docs/html-intl/intl/zh-cn/google/play/billing/billing_testing.jd new file mode 100644 index 0000000000000..2dcc7a4f63834 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/google/play/billing/billing_testing.jd @@ -0,0 +1,190 @@ +page.title=测试应用内结算 +parent.title=In-app Billing +parent.link=index.html +@jd:body + + + +

      Google Play 开发者控制台提供了一些帮助你测试应用内结算实施情况的工具：

      + + + +

      要测试应用的应用内结算，必须将该应用安装在 Android 设备上。你不能使用 Android 模拟器测试应用内结算。用于测试的设备必须运行标准的 Android 1.6 或更高版本的平台（API 级别 4 或更高级别），并且要安装最新版本的 Google Play 应用。如果设备运行的不是最新的 Google Play 应用，你的应用将不能向 Google Play 发送应用内结算请求。有关如何设置设备以便用于开发 Android 应用的一般信息，请参阅使用硬件设备。

      + +

      测试应用内购买

      + +

      应用内结算实施就绪后，你可以通过两种方法测试应用内 SKU 的购买：

      + + + +

      下面的各个部分介绍了有关如何使用这些方法进行测试和验证的详情。

      + +

      测试购买（应用内结算沙盒）

      + +

      测试购买提供了一种安全、方便的方法，让你在开发过程中或准备发布期间，对你的应用内结算实施情况进行大规模的测试。测试期间，经过授权的用户帐户可在你的应用尚未发布时通过 Google Play 购买应用内商品，不过这些用户帐户不用实际支付费用。

      + +

      获得测试访问权限之后，这些用户可以侧载你的应用，并测试商品的完整销售、购买和订单完成流程。测试购买会产生真实的订单，Google Play 会采用与处理其他订单相同的方式对其进行处理。购买完成后，Google Play 不会让这些订单进入财务流程，从而确保不会向用户帐户实际收取费用，并在 14 天后自动取消已完成的订单。

      + +

      设置测试购买

      + +

      设置测试购买很简单，你可以选择任何用户帐户作为测试帐户，而测试帐户中的任何用户都可以通过可用的付款方式进行测试购买（当然用户不需要通过付款方式支付任何费用）。

      + +

      首先，上传并发布你希望测试者能够购买的应用内商品。你可以在开发者控制台中上传和发布应用内商品。请注意，你可以在发布 APK 之前上传并发布应用内商品。

      + +

      然后，为获得授权的用户创建许可测试帐户。在开发者控制台中，转到设置 > 帐户详情，然后在“许可测试”部分将相应地址添加到可用于测试的 Gmail 帐户字段。有关详情，请参阅设置测试购买。

      + +

      在你将用户添加为许可测试帐户并保存更改之后，这些用户在 15 分钟内即可开始购买你的应用内商品。随后你可以向测试者发布你的应用并提供收集反馈的方法。

      + +

      注意：要进行测试购买，许可测试帐户必须设置在用户的 Android 设备上。如果设备上有多个帐户，则必须使用下载应用时所用的帐户进行购买。如果没有帐户下载过应用，则使用第一个帐户进行购买。用户可以通过展开购买对话框来确认执行购买的帐户。

      + +

      测试购买和开发者帐户

      +

      经过授权的许可测试帐户在 Google Play 中与你的开发者帐户相关联，而不是与特定 APK 或程序包名称相关联。被标识为测试帐户的帐户可以购买你帐户的任何应用内商品而不用支付费用。

      + +

      购买流程的详情

      +

      在测试购买期间，用户可以测试应用中实际的销售、购买和订单完成流程。购买时，应用内商品与普通商品一样显示，并包含实际价格。不过，Google Play 会在购买对话框中心处显示通知，说明这是测试购买，以便辨识。 +

      + +

      取消已完成的测试购买

      +

      Google Play 会累积每个用户已完成的测试购买，但不会将相关信息传递到财务流程。经过一段时间后，Google Play 会自动取消这些购买以进行清理。

      + +

      在某些情况下，你可能希望手动取消测试购买以便继续进行测试。要取消购买，你可以：

      + + + +

      使用测试购买的要求

      +

      如果你打算使用测试购买，请注意以下要求和限制：

      + + +

      使用真实交易进行测试

      +

      在准备发布使用应用内结算的应用时，你可以先利用 Google Play Alpha/Beta 发布选项进行来验证和负荷测试你的应用内结算实施情况，然后再向所有用户发布应用。

      + +

      Alpha/Beta 测试小组内的真实用户（由你选择）可以通过 Google Play 安装你的应用并测试应用内商品。他们可以通过其在 Google Play 中的常规付款方式进行真正的购买，而他们的帐户中会产生实际费用。请注意，如果你的 Alpha 和 Beta 发布小组中包括测试许可帐户，这些用户将只能进行测试购买。

      + + +

      使用静态回复进行测试

      + +

      我们建议你先使用来自 Google Play 的静态回复测试应用内结算的实施情况。这样一来，你可以确认应用能否正确处理主要 Google Play 回复，以及你的应用能否正确验证签名。即使应用尚未发布，你也可以执行此测试。

      + +

      要使用静态回复测试你的实施，请使用具有预留的商品 ID 的特定商品发送应用内结算请求。每个预留的商品 ID 均会从 Google Play 返回特定的静态回复。当你使用预留的商品 ID 发送应用内结算请求时不会发生资金转移。此外，当你使用预留的商品 ID 发送结算请求时不能指定付款方式。图 1 显示了商品 ID 为“android.test.purchased”的预留商品的结帐流程。

      + + +

      + 图 1. 特定的预留商品“android.test.purchased”的电子钱包流程 +

      + +

      你不需要在应用的商品列表中列出预留的商品。Google Play 已经知道预留的商品 ID。此外，你不需要将应用上传到开发者控制台，就可以使用预留的商品 ID 执行静态回复测试。你只需在设备上安装你的应用，登录到设备，然后使用预留的商品 ID 发送结算请求。

      + +

      注意：过去，你可以通过上传未发布的“草稿”版本来测试应用，但现在系统已不再支持此功能。不过，现在你可以在将应用上传到 Google Play 商店之前就使用静态回复测试应用。有关详情，请参阅草稿应用不再受支持。 + +

      用于测试静态应用内结算回复的预留商品 ID 有四种：

      + + + +

      在某些情况下，预留的商品可能会返回经过签名的静态回复，这样你可以测试应用中的签名验证。只有当运行应用的用户拥有开发者帐户或测试帐户时，预留的商品才返回经过签名的回复。 + +

      要使用预留的商品 ID 发送应用内结算请求，你只需构建一个常规的 REQUEST_PURCHASE 请求即可，不过请使用上文介绍的一个预留商品 ID，而不要使用你的应用商品列表中的真实商品 ID。

      + +

      要使用预留的商品 ID 测试应用，请按以下步骤操作：

      + +
        +
      1. 在 Android 设备上安装你的应用。 +

        你不能使用模拟器测试应用内结算，而是必须在设备上安装应用才能测试应用内结算。

        +

        要了解如何在设备上安装应用，请参阅在设备上运行。

        +
        2. +
      2. 使用你的开发者帐户登录到设备。 +

        如果你只是使用预留的商品 ID 进行测试，则不需要使用测试帐户。

        +
        3. +
      3. 确保你的设备运行的是受支持的 Google Play 应用版本或 MyApps 应用版本。 +

        如果你的设备运行的是 Android 3.0，则应用内结算要求使用版本为 5.0.12（或更高版本）的 MyApps 应用。如果你的设备运行的是其他版本的 Android，则应用内结算要求使用版本为 2.3.4（或更高版本）的 Google Play 应用。要了解如何查看 Google Play 应用的版本，请参阅更新 Google Play。

        +
        4. +
      4. 运行应用并购买预留的商品 ID。
        5. +
      + +

      注意：使用预留的商品 ID 发送应用内结算请求会覆盖常用的 Google Play 生产系统。当你针对某个预留的商品 ID 发送应用内结算请求时，服务的质量会比不上生产环境。

      + +

      设置测试真实购买

      + +

      完成静态回复测试，并确认应用中的签名验证正常工作之后，你就可以通过执行实际的应用内购买，来测试应用内结算的实施情况。测试真实的应用内购买能让你测试端到端的应用内结算体验，包括从 Google Play 进行实际购买，以及用户在你的应用中体验的实际结帐流程。

      + +

      注意：你可以将应用发布到 Alpha 发布渠道来进行端到端的测试。也就是说，这样做你可以将应用发布到 Google Play 商店，但限制为仅向你指定的测试者提供该应用。

      + +

      要通过实际的应用内购买测试你的应用内结算实施情况，请在 Google Play 开发者控制台注册至少一个测试帐户。你不能使用自己的开发者帐户测试完整的应用内购买流程，因为 Google 电子钱包不允许你购买自己的商品。如果你之前没有设置过测试帐户，请参阅设置测试帐户。

      + +

      此外，测试帐户只能购买你的商品列表中已经发布的商品。虽然你可以不发布应用，但必须发布商品。

      + +

      要通过实际购买测试你的应用内结算实施情况，请按以下步骤操作：

      + +
        +
      1. 通过开发者控制台将你的应用上传到 Alpha 发布渠道。 + +

        注意：过去，你可以通过上传未发布的“草稿”版本来测试应用，但现在系统已不再支持此功能。现在你必须将应用发布到 Alpha 或 Beta 发布渠道，才能进行测试。有关详情，请参阅草稿应用不再受支持。 + +

        2. +
      2. 将商品添加到应用的商品列表。 +

        请务必发布商品（应用可以保持未发布状态）。要了解如何操作，请参阅创建商品列表。

        +
        3. +
      3. 在 Android 设备上安装你的应用。 +

        你不能使用模拟器测试应用内结算，而是必须在设备上安装应用才能测试应用内结算。

        +

        要了解如何在设备上安装应用，请参阅在设备上运行。

        +
        4. +
      4. 确保你的设备运行的是受支持的 Google Play 应用版本或 MyApps 应用版本。 +

        如果你的设备运行的是 Android 3.0，则应用内结算要求使用版本为 5.0.12（或更高版本）的 MyApps 应用。如果你的设备运行的是其他版本的 Android，则应用内结算要求使用版本为 2.3.4（或更高版本）的 Google Play 应用。要了解如何查看 Google Play 应用的版本，请参阅更新 Google Play。

        +
        5. +
      5. 在应用中进行应用内购买。
        6. +
      + +

      注意：在设备上更改主要帐户的唯一方法是恢复出厂设置，请确保先使用你的主要帐户在设备上登录。

      + +

      完成对应用内结算实施情况的测试之后，你就可以在 Google Play 上发布应用了。你可以按照常规步骤准备、登录以及在 Google Play 上发布。 +

      + +

      草稿应用不再受支持

      + +

      过去，你可以发布应用的“草稿”版本进行测试，但现在系统已不再支持此功能。现在你可以通过两种方法在 Google Play 商店中测试预览版应用的功能运行情况：

      + + \ No newline at end of file diff --git a/docs/html-intl/intl/zh-cn/google/play/billing/index.jd b/docs/html-intl/intl/zh-cn/google/play/billing/index.jd new file mode 100644 index 0000000000000..2ddd26480a62d --- /dev/null +++ b/docs/html-intl/intl/zh-cn/google/play/billing/index.jd @@ -0,0 +1,47 @@ +page.title=Google Play 应用内结算 +page.metaDescription=应用内计费可让你以一次性的购买或订阅方式去销售数码内容。 +page.image=/images/play_dev.jpg + +@jd:body + +

      应用内结算是一项 Google Play 服务，可让你在自己的应用内销售数字内容。你可以使用该服务销售很多内容，包括媒体文件或照片等可下载的内容、游戏关卡或药水等虚拟内容、高级服务及功能，等等。你可以使用应用内结算销售下面这两类商品：

      + +
      +
      +

      应用内结算的新变化

      +
        +
      • IAB 第 2 版关闭 - 应用内结算 API 第 2 版已弃用，将于 2015 年 1 月关闭。如果你的应用仍在使用应用内结算第 2 版，请尽快迁移到 API 第 3 版。
        • +
      • 季节性订阅 - 你现在可以设置定期的季节性订阅，即订阅在每年的同一天开始并在同一天结束（例如，每年 9 月 1 日开始、次年 4 月 10 日结束的体育订阅）。
        • +
      • 推迟订阅结算 - 你可以将订阅者的下一个结算日推迟到你选择的日期。用户在推迟期内仍能访问相关内容，但不用缴费。
        • +
      • Google Play Developer API - 利用 Google Play Developer API，你可以执行各种发布和应用管理任务。该 API 中包含之前称为“Purchase Status API”的功能。
        • +
      • 撤消订阅/退还订阅费 - 你可以使用 Google Play Developer API 撤消用户的订阅并退还其订阅费。如果你这样做，用户的订阅将立即结束，且系统会退还其最近的订阅付款。
        • +
      • 应用内结算第 3 版 - 最新版本的应用内结算采用更易实施的同步 API，可让你更有效地管理应用内商品和订阅。
        • +
      +
      +
      + + + +

      如果你使用应用内结算服务来销售商品，那么无论你销售的是应用内商品还是订阅，Google Play 都会负责处理所有结帐详情，因此你的应用从不需要直接处理任何财务交易。Google Play 使用的结帐后端服务与用于应用购买的服务相同，因此你的用户将获得一致且熟悉的购买流程使用体验。

      + +

      你通过 Google Play 发布的所有应用都可以实施应用内结算。只要你有 Google Play 开发者控制台帐户和 Google 电子钱包商家帐户（无需创建任何特殊帐户或进行任何注册），即可实施该服务。

      + +

      为了帮你将应用内结算集成到你的应用中，Android SDK 提供了一个示例应用，向你演示如何在应用内销售标准的应用内商品和订阅。

      + +

      要开始使用应用内结算，请先阅读下面介绍的文档或参加销售应用内商品培训课程。

      + +
      +
      概述
      +
      请阅读本文，了解应用内结算的基本概念。
      +
      API 第 3 版
      +
      请阅读这部分中的文档，了解应用内结算最新版本概述以及实施详情和 API 参考。
      +
      安全性和设计
      +
      请参阅这些最佳做法，以帮助确保你的应用内结算实施安全稳妥、设计合理。
      +
      测试应用内结算
      +
      了解应用内结算测试工具的工作原理，以及如何测试应用内结算实施。
      +
      管理应用内结算
      +
      了解如何设置商品列表、注册测试帐户以及处理退款。
      +
      diff --git a/docs/html-intl/intl/zh-cn/index.jd b/docs/html-intl/intl/zh-cn/index.jd new file mode 100644 index 0000000000000..590332f9d0e6b --- /dev/null +++ b/docs/html-intl/intl/zh-cn/index.jd @@ -0,0 +1,107 @@ +fullpage=true +page.viewport_width=970 +excludeFromSuggestions=true +page.metaDescription=The official site for Android developers. Provides the Android SDK and documentation for app developers and designers. +page.customHeadTag= + +@jd:body + + + + + +
      +
      +
      +
      + +
      +
      + +
      +
      +
      +

      Android 5.0 Lollipop

      +

      在 Android 5.0 的版本更新中，我们添加了多种可用于你的应用程序的新功能，比如锁屏通知,一个全新的相机API，OpenGL ES 3.1，以及新的 Material Design 界面等等。

      + 了解详情 +
      +
      +
      +
      +

       

      + +
      + +
      +
      +
      +
      + + + + +
      +
      +
      + + + + +
      +
      +
      + + + +
      +
      +
      +
      + +
      专为跨屏世界打造
      +
      + 全球数亿手持设备安装的都是 Android 系统。
      + 现在 Android 系统还支持以下这些备受期待的新设备。 +
      +
      +
      +
      +
      + + +

      + 让用户随时随地获得需要的信息。 +

      +

      + 了解 Android Wear +

      +
      +
      + + +

      + 针对大屏幕打造应用，使你的内容引人入胜。 +

      +

      + 了解 Android TV + +

      +
      +
      + + +

      + 将你的音乐应用扩展到车载娱乐系统。 +

      +

      + 了解 Android Auto +

      +
      +
      +
      +
      +
      \ No newline at end of file diff --git a/docs/html-intl/intl/zh-cn/resources.jd b/docs/html-intl/intl/zh-cn/resources.jd new file mode 100644 index 0000000000000..3c2abd39bd062 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/resources.jd @@ -0,0 +1,57 @@ +page.title=中文资源 +page.viewport_width=970 +page.type=guide +section.landing=true +header.hide=1 +nonavpage=true +page.metaDescription=我们翻译了以下一些网站资源，希望能帮助你开始设计、开发和在全球发布你的Android应用。 + +@jd:body + +
      +
      + +
      + +

      你的语言的资源

      +

      我们翻译了以下一些网站资源，希望能帮助你开始设计、开发和发布你的Android应用程序到全球。

      + +

      检查清单

      + +
      + +

      Google Play 应用内结算

      + +
      + +

      工具

      + +
      + +

      培训

      + +
      + + +
      + diff --git a/docs/html-intl/intl/zh-cn/tools/help/proguard.jd b/docs/html-intl/intl/zh-cn/tools/help/proguard.jd new file mode 100644 index 0000000000000..0e8cc7a580938 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/tools/help/proguard.jd @@ -0,0 +1,133 @@ +page.title=ProGuard +parent.title=Tools +parent.link=index.html +page.type=工具 +@jd:body + + + +

      ProGuard 工具通过移除无用的代码以及使用语义隐晦的名称来重命名类、字段和方法，从而达到压缩、优化和混淆代码的目的。最终您将获得一个较小的 .apk 文件，此文件更难于进行反向工程。由于 ProGuard 会使应用更难于进行反向工程，因此当应用使用对安全性要求极高的功能时（例如，当您向应用授予许可时），您必须使用此工具。

      + +

      ProGuard 已集成到 Android 构建系统，所以您无需手动调用此工具。只有当您在发布模式下构建应用时，ProGuard 才会运行，因此当您在调试模式下构建应用时，就无需处理混淆后的代码。是否运行 ProGuard 完全由您决定，但我们强烈建议您运行该工具。

      + +

      本文介绍如何启用和配置 ProGuard，以及如何使用 retrace 工具解码混淆后的堆栈跟踪信息。

      + +

      启用 ProGuard

      + +

      当您创建 Android 项目时，系统会在该项目的根目录中自动生成一个 proguard.cfg 文件。此文件将定义 ProGuard 会如何优化和混淆代码，因此您必须了解如何根据自己的需求对其进行自定义。默认的配置文件只涵盖一般的使用情形，因此您极有可能需要根据自己的需求对其进行修改。请参阅下文配置 ProGuard 这一部分，了解如何自定义 ProGuard 配置文件。

      + +

      要启用 ProGuard，让其作为 Ant 或 Eclipse 构建环境的一部分运行，请在 <project_root>/project.properties 文件中设置 proguard.config 属性。该路径可以是绝对路径，也可以是项目根目录的相对路径。

      + +

      注意：在使用 Android Studio 时，您必须将 Proguard 添加到 gradle.build 文件的构建类型中。有关详情，请参阅 Gradle 插件用户指南。 + +

      如果您将 proguard.cfg 文件留在默认位置（项目的根目录中），则可以按如下格式指定其位置：

      + 
      +  proguard.config=proguard.cfg
+
      +

      + 您也可以将此文件移到任何所需的位置，然后按如下格式指定其绝对路径： +

      + 
      +  proguard.config=/path/to/proguard.cfg
+
      + + +

      当您在发布模式下构建应用时，无论是通过运行 ant release 还是通过使用 Eclipse 中的“导出向导”，构建系统都会自动检查是否设置了 proguard.config 属性。如果已设置该属性，ProGuard 会自动处理应用的字节码，然后再将所有内容打包到 .apk 文件中。在调试模式下进行构建时之所以不调用 ProGuard，是因为该工具会加大调试难度。

      + +

      ProGuard 在运行后会输出以下文件：

      + +
      +
      dump.txt
      +
      描述 .apk 文件中所有类文件的内部结构
      + +
      mapping.txt
      +
      列出原始与混淆后的类、方法和字段名称之间的对应关系。如果您从发布版本收到问题报告，则必须使用此文件，因为通过它可将混淆后的堆栈跟踪信息转换为原始的类、方法和成员名称。有关详情，请参阅解码混淆后的堆栈跟踪信息。
      + +
      seeds.txt
      +
      列出未混淆的类和成员
      + +
      usage.txt
      +
      列出从 .apk 删除的代码
      +
      + +

      这些文件都位于以下目录中：

      + +
        +
      • <project_root>/bin/proguard（如果您使用的是 Ant）。
        • + +
      • <project_root>/proguard（如果您使用的是 Eclipse）。
        • +
      + + +

      注意：每当您在发布模式下构建版本时，这些文件都会被 ProGuard 最新生成的文件覆盖。请在每次发布应用时为这些文件保存一份副本，以便反混淆来自发布版本的问题报告。如需详细了解为何要保存这些文件，请参阅调试已发布应用时应注意的事项。 +

      + +

      配置 ProGuard

      + +

      在某些情况下，proguard.cfg 文件中的默认配置足以满足您的需求。不过，在很多情况下，ProGuard 很难做出正确分析，因此可能会移除它认为无用而实际上您的应用却需要的代码。部分示例如下：

      + +
        +
      • 一个只在 AndroidManifest.xml 文件中引用的类
        • + +
      • 一个通过 JNI 调用的方法
        • + +
      • 动态引用的字段和方法
        • +
      + +

      默认的 proguard.cfg 文件旨在涵盖一般的使用情形，但您可能会遇到异常情况，例如 ClassNotFoundException（此异常情况会在 ProGuard 删除您的应用调用的整个类时发生）。

      + +

      您可以通过在 proguard.cfg 文件中添加一个 -keep 行，来修复因 ProGuard 在删除代码而造成的错误。例如：

      + 
      +  -keep public class <MyClass>
+
      + +

      在使用 -keep 选项时，您既有许多选择也有不少需要注意的方面，因此我们强烈建议您阅读 ProGuard 手册，详细了解如何自定义您的配置文件。该手册中的“Keep 选项概述”和“示例”部分尤其有用；问题排查部分则概述了在 ProGuard 删除代码后您可能会遇到的其他常见问题。

      + +

      解码混淆后的堆栈跟踪信息

      + +

      当混淆后的代码输出堆栈跟踪信息时，方法名称会被混淆，即便仍能进行调试，难度也会很大。幸运的是，ProGuard 在每次运行时都会输出一个 <project_root>/bin/proguard/mapping.txt 文件，其中会显示与混淆后的名称相对应的原始的类、方法和字段名称。

      + +

      Windows 上的 retrace.bat 脚本以及 Linux 或 Mac OS X 上的 retrace.sh 脚本可以将混淆后的堆栈跟踪信息转换成可读文件，此文件位于 <sdk_root>/tools/proguard/ 目录中。执行 retrace 工具的语法如下：

      + 
      retrace.bat|retrace.sh [-verbose] mapping.txt [<stacktrace_file>]
      +

      例如：

      + + 
      retrace.bat -verbose mapping.txt obfuscated_trace.txt
      + +

      如果您不为“<stacktrace_file>”指定值，retrace 工具会从标准输入中读取。

      + +

      调试已发布应用时应注意的事项

      + +

      每次向用户发布应用时，都请保存所发布版本的 mapping.txt 文件。这样一来，如果用户遇到问题，并向您提交混淆后的堆栈跟踪信息，您就可以利用为每个发布版本保存的 mapping.txt 文件副本调试问题。每当您构建发布版本时，项目的 mapping.txt 文件都会被覆盖，因此您必须谨慎保存所需的版本。

      + +

      例如，假设您发布了某个应用，并继续开发该应用的新功能，以便将来发布新版本。之后不久您使用 ProGuard 构建发布版本。此版本覆盖了之前的 mapping.txt 文件。之后，某位用户提交了问题报告，其中包含来自当前已发布的应用的堆栈跟踪信息。但您已无法调试该用户的堆栈跟踪信息，因为与该用户设备上的版本相关联的 mapping.txt 文件已被覆盖。除此之外，其他一些情况也可能会导致您的 mapping.txt 文件被覆盖。因此，如果您预计需要进行调试，请务必在每次发布应用时都保存一份副本。

      + +

      如何保存 mapping.txt 文件由您自行决定。例如，您可以将其重命名以使其名称中包含版本号，也可以对其（连同源代码一起）进行版本管理。

      diff --git a/docs/html-intl/intl/zh-cn/tools/publishing/preparing.jd b/docs/html-intl/intl/zh-cn/tools/publishing/preparing.jd new file mode 100644 index 0000000000000..46938b985e45f --- /dev/null +++ b/docs/html-intl/intl/zh-cn/tools/publishing/preparing.jd @@ -0,0 +1,186 @@ +page.title=准备发布 +page.type=工具 + +@jd:body + +
      +
      +

      概述

      +
        +
      • 了解发布应用需要哪些资源。
        • +
      • 了解如何配置和构建应用以进行发布。
        • +
      • 了解发布应用的最佳做法。
        • +
      +

      本文内容

      +
        +
      1. 简介
        2. +
      2. 收集材料和资源
        3. +
      3. 配置应用
        4. +
      4. 构建应用
        5. +
      5. 准备外部服务器和资源
        6. +
      6. 测试应用以进行发布
        7. +
      +

      另请参见

      +
        +
      1. 发布概述
        2. +
      2. 为应用签名
        3. +
      3. Google Play 发布检查清单
        4. +
      +
      +
      + +

      在将您的 Android 应用分发给用户之前，您需要先完成准备工作。对于所有 Android 应用，准备流程都是一项必须完成的开发任务，也是发布流程中的第一步（参见图 1）。

      + +

      当准备应用以进行发布时，您需要配置、构建并测试应用的发布版本。配置任务相当简单，涉及完成代码清理和代码修改这两项基本任务，从而达到优化应用的目的。构建流程与调试构建流程相似，可以使用 JDK 和 Android SDK 工具完成。测试任务就是做最终检查，以确保您的应用能在实际环境下正常运行。准备好要发布的应用后，您将获得一个已签名的 .apk 文件。您可以直接将该文件分发给用户，也可以通过 Google Play 等应用市场进行分发。

      + +

      本文总结了您在准备应用以进行发布时需执行的几大任务。这些任务适用于所有 Android 应用，无论这些应用采用什么方式发布或分发给用户。如果您要通过 Google Play 发布应用，则还应查看 Google Play 发布检查清单，以确保您要发布的应用满足 Google Play 的所有要求。

      + +

      注意：在您执行本文所述任务之前，最好确保您的应用符合针对功能、性能和稳定性的所有发布标准。

      + + 显示发布流程在整个开发流程中的位置 +

      + 图 1. 准备发布是一项必须完成的开发任务，也是发布流程中的第一步。 +

      + +

      简介

      + +

      为了向用户发布应用，您需要先创建发布版应用包，以供用户在其 Android 设备上安装和运行。发布版应用包与调试 .apk 文件中包含的组件相同（经过编译的源代码、资源、清单文件等），使用的构建工具也相同。不过，与调试 .apk 文件不同的是，发布版 .apk 文件已使用您自己的证书签名且使用 Zipalign 工具进行了优化。

      + +
      + 显示准备应用以进行发布所需执行的五项任务 +

      + 图 2. 要准备应用以进行发布，您需执行五大任务。 +

      +
      + +

      通常情况下，如果您使用 Eclipse 和 ADT 插件或 Ant 构建脚本（包含在 Android SDK 中）构建应用，可以无缝地完成签名和优化任务。例如，您可以使用 Eclipse“导出向导”一次性完成对应用的编译、签名和优化操作。如果通过命令行进行构建，您还可以配置 Ant 构建脚本来执行相同的操作。

      + +

      要准备应用以进行发布，您通常需要执行五大任务（参见图 2）。每项大任务可能包含一项或多项小任务，视您的应用发布方式而定。例如，如果您要通过 Google Play 发布应用，则可能需要在配置应用的发布版本时向清单中添加特殊的过滤规则。同样，为了满足 Google Play 发布指南的要求，您可能需要在收集发布材料时准备几张屏幕截图并撰写相关宣传文字。

      + +

      一般来说，在对应用进行了全面调试和测试后，您需要执行图 2 中列出的任务。Android SDK 中提供的几种工具可帮您测试和调试您的 Android 应用。有关详情，请参阅开发者指南中的调试和测试这两部分。

      + +

      收集材料和资源

      + +

      要开始准备应用以进行发布，您需要收集几项支持性的信息，其中至少应包含用于为应用签名的加密密钥以及应用图标。此外，您可能还需要提供最终用户许可协议。

      + +

      加密密钥

      + +

      Android 系统要求安装的每个应用都必须使用应用开发者拥有的证书（即开发者用于存放私钥的证书）进行数字签名。Android 系统利用该证书来识别应用作者并在应用之间建立信任关系。您用于签名的的证书无需由证书机构签名；Android 系统允许您使用自签名证书为您的应用签名。如需了解有关证书的要求，请参阅获取合适的私钥。

      + +

      重要提示：您的应用必须使用在 2033 年 10 月 22 日之后才会失效的加密密钥签名。

      + +

      如果您应用访问的服务或使用的第三方库需要基于您的私钥的附加密钥，则您还必须获得其他发布密钥。例如，如果您的应用使用 MapView 类（属于 Google 地图外部库），您需要让您的应用注册 Google 地图服务并获取 Maps API 密钥。如需了解如何获取 Maps API 密钥，请参阅获取 Maps API 密钥。

      + +

      应用图标

      + +

      请确保您有应用图标而且图标遵守建议的图标指南。应用的图标会显示在设备的主屏幕上和“启动器”窗口中，有助于用户识别您的应用。它还会显示在“管理应用”、“我的下载”等其他位置。此外，Google Play 等发布服务也会向用户显示您的应用图标。

      + +

      注意：如果您要在 Google Play 上发布应用，则需要创建高分辨率版本的图标。有关详情，请参阅应用的图形资源。

      + +

      最终用户许可协议

      + +

      请考虑为您的应用准备最终用户许可协议 (EULA)。最终用户许可协议可帮助保护您的员工、公司和知识产权，因此我们建议您为自己的应用提供一份。

      + +

      其他材料

      + +

      您可能还需要准备宣传和营销材料，用来宣传您的应用。例如，如果您要在 Google Play 上发布应用，则需要准备几段宣传文字并创建几张应用截图。有关详情，请参阅应用的图形资源

      + +

      配置应用以进行发布

      + +

      收集完所有支持材料后，您可以开始配置应用以进行发布。这部分总结了一些建议您在发布应用前对源代码、资源文件和应用清单进行的配置更改。虽然是否实施这里列出的大部分配置更改都由您决定，但这些都是良好的编码习惯。因此我们建议您实施这些更改。在某些情况下，您可能已在开发过程中实施了这些配置更改。

      + +

      选择合适的应用包名称

      + +

      请确保您选择的应用包名称适合在应用的整个生命周期中使用。将应用分发给用户后，您就无法再更改应用包名称。您可以在应用的清单文件中设置应用包名称。有关详情，请参阅介绍 package 属性的文档。

      + +

      停用日志记录和调试功能

      + +

      在构建应用的发布版本之前，请确保停用日志记录功能和调试选项。要停用日志记录功能，您可以移除源文件中对 Log 方法的调用。要停用调试功能，您可以从清单文件的 <application> 代码中移除 android:debuggable 属性或将 android:debuggable 属性设置为 false。此外，请移除您在项目中创建的所有日志文件或静态测试文件。

      + +

      此外，您还应移除之前添加到代码中的所有 Debug 跟踪调用，例如 startMethodTracing() 和 stopMethodTracing() 方法调用。

      + +

      重要提示：调试功能允许用户使用 Chrome DevTools 注入脚本和提取内容，因此如果您使用 WebView 展示付费内容或使用 JavaScript 界面，请确保停用应用的调试功能。要停用调试功能，请使用 WebView.setWebContentsDebuggingEnabled() 方法。

      + +

      清理项目目录

      + +

      请清理您的项目，确保其符合 Android 项目中所述的目录结构要求。项目中留有散乱或孤立的文件会妨碍对应用的编译，导致应用发生异常。您至少应执行下列清理任务：

      + +
        +
      • 查看 jni/、lib/ 和 src/ 目录的内容。jni/ 目录应只包含与 Android NDK 相关联的源文件，例如 .c、.cpp、.h 和 .mk 文件。lib/ 目录应只包含第三方库文件或专用库文件，包括预构建的共享库和静态库（例如 .so 文件）。src/ 目录应只包含应用的源文件（.java 和 .aidl 文件）。src/ 不应包含任何 .jar 文件。
        • +
      • 检查项目中是否包含应用不需要的专用或专有数据文件，如果有请将其移除。例如，在项目的 res/ 目录中查找是否包含旧的图形文件、布局文件和值文件，如果您不再使用这些文件，请将其删除。
        • +
      • 检查 lib/ 目录中是否包含测试库；如果您的应用不再使用这些库，请将其移除。
        • +
      • 查看 assets/ 目录和 res/raw/ 目录的内容，查找其中是否包含需在应用发布前更新或移除的原始资源文件和静态文件。
        • +
      + +

      查看并更新清单设置

      + +

      确认下列清单项是否已正确设置：

      + +
        +
      • + <uses-permission> 元素 +

        您应该只指定应用必需的相关权限。

        +
        • +
      • android:icon 和 android:label 属性 +

        您必须为这些属性（位于 <application> 元素中）指定值。

        +
        • +
      • android:versionCode 和 android:versionName 属性。 +

        我们建议您为这些属性（位于 <manifest> 元素中）指定值。有关详情，请参阅应用的版本管理。

        +
        • +
      + +

      如果您要在 Google Play 上发布应用，还可以设置另外几个清单元素。例如，android:minSdkVersion 和 android:targetSdkVersion 属性（位于 <uses-sdk> 元素中）。如需详细了解这些设置以及其他 Google Play 设置，请参阅 Google Play 上的过滤器。

      + +

      解决兼容性问题

      + +

      Android 提供了多种工具和技术，可让您的应用与多种设备兼容。为了让您的应用尽可能地适合更多用户，建议您执行以下操作：

      + +
        +
      • 添加跨屏配置支持 +

        确保您采取了支持跨屏的最佳做法。通过支持跨屏配置，您创建的应用可在 Android 支持的任何屏幕尺寸的设备上正常运行且拥有精美外观。

        +
        • +
      • 针对 Android 平板电脑优化应用 +

        如果您的应用是专为运行 Android 3.0 以上版本的设备打造的，请遵照针对 Android 3.0 优化应用中所述的指南和最佳做法，这样您的应用就能与运行 Android 3.0 的设备兼容。

        +
        • +
      • 考虑使用支持库 +

        如果您的应用是专为运行 Android 3.x 的设备打造的，请向您的应用项目中添加支持库，这样您的应用就能与较低版本的 Android 系统兼容。您可以将“支持库”提供的静态支持库添加到您的 Android 应用中，以便使用低版本的平台上未提供的 API 或使用不属于框架 API 的实用程序 API。

        +
        • +
      + +

      更新服务器和服务的网址

      + +

      如果您的应用需要访问远程服务器或服务，请确保您使用的是该服务器或服务的生产网址或路径，而非测试网址或路径。

      + +

      实施许可服务（如果您要在 Google Play 上发布应用）

      + +

      如果您要通过 Google Play 发布付费应用，请考虑支持 Google Play 许可服务。借助这项许可服务，您可以根据当前用户的购买情况控制其对您应用的访问权限。使用 Google Play 许可服务并不是强制的，即使您通过 Google Play 发布应用也可以不使用这项服务。

      + +

      如需详细了解 Google Play 许可服务以及如何在应用中使用该服务，请参阅应用许可。

      + +

      构建应用以进行发布

      + +

      配置好应用后，您可以将其构建为一个经过签名和优化的发布版 .apk 文件。JDK 中包含用于为 .apk 文件签名的工具（Keytool 和 Jarsigner）；Android SDK 中包含用于编译和优化 .apk 文件的工具。如果您使用的是带 ADT 插件的 Eclipse 或是从命令行使用 Ant 构建脚本，则整个构建流程可以自动完成。

      + +

      使用 Eclipse 进行构建

      + +

      您可以使用 Eclipse“导出向导”构建使用私钥签名并经过优化的发布版 .apk 文件。如需了解如何运行“导出向导”，请参阅使用 Eclipse ADT 进行编译和签名。“导出向导”会对您要发布的应用进行编译、使用私钥为应用签名并使用 Zipalign 工具对应用进行优化。如果您已通过 Eclipse 运行或调试过应用且未在应用中发现错误，“导出向导”就应该能成功运行（有关详情，请参阅使用带 ADT 的 Eclipse 构建和运行应用）。

      + +

      “导出向导”假设您有适合为应用签名的证书和私钥。如果您没有合适的证书和私钥，“导出向导”将帮您生成一个（如需详细了解签名流程和签名指南，请参阅为应用签名）。

      + +

      使用 Ant 进行构建

      + +

      您可以使用 Ant 构建脚本（包含在 Android SDK 中）来构建使用私钥签名并经过优化的发布版 .apk 文件。如需了解具体做法，请参阅在发布模式下进行构建。这种构建方式假设您有适合为应用签名的证书和密钥。如果您没有合适的证书和私钥，“导出向导”将帮您生成一个（如需详细了解签名流程和签名指南，请参阅为应用签名）。

      + +

      准备外部服务器和资源

      + +

      如果您的应用依赖于远程服务器，请确保该服务器是安全的且已经过配置，随时可投入实际使用。如果您要在应用中实施应用内结算，而且要在远程服务器上执行签名验证步骤，则必须这样做。

      + +

      此外，如果您的应用从远程服务器或实时服务中抓取内容（例如内容 Feed），请确保您提供的内容是最新的且随时可投入实际使用。

      + +

      测试应用以进行发布

      + +

      测试应用的发布版本有助于确保您的应用能在实际设备上和实际网络条件下正常运行。理想情况下，您至少应在一部手持设备上和一台平板电脑上测试您的应用，以确认界面元素的尺寸是否合适，以及应用的性能和能耗是否可接受。

      + +

      在测试之前，请先参阅测试内容。这篇文章总结了您在测试 Android 应用时应注意的常见情况。当您完成测试并确定应用的发布版本能正常运行后，就可以向用户发布您的应用了。有关详情，请参阅向用户发布应用。如果您要在 Google Play 上发布应用，请参阅 Google Play 发布检查清单。

      + + diff --git a/docs/html-intl/intl/zh-cn/tools/publishing/publishing_overview.jd b/docs/html-intl/intl/zh-cn/tools/publishing/publishing_overview.jd new file mode 100644 index 0000000000000..eb6a617f8e2f6 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/tools/publishing/publishing_overview.jd @@ -0,0 +1,142 @@ +page.title=发布概述 +page.type=工具 + +@jd:body + +
      +
      +

      概述

      +
        +
      • 了解如何发布 Android 应用。
        • +
      • 了解如何准备应用以进行发布。
        • +
      • 了解如何向用户发布应用。
        • +
      +

      本文内容

      +
        +
      1. 准备应用以进行发布
        2. +
      2. 向用户发布应用 +
      +

      另请参见

      +
        +
      1. 在 Google Play 上发布应用
        2. +
      +
      +
      + +

      发布是将您的 Android 应用提供给用户的常规流程。您在发布 Android 应用时需要执行两大任务：

      + +
        +
      • 准备应用以进行发布。 +

        在准备阶段，您需要构建应用的发布版本，以供 Android 设备用户下载和安装。

        +
        • +
      • 向用户发布应用。 +

        在发布阶段，您向用户宣传、销售和分发应用的发布版本。

        +
        • +
      + +

      通常情况下，您可以通过 Google Play 等应用市场发布应用。不过，您也可以通过以下方式发布应用：将应用直接发送给用户；让用户从您的网站下载应用。

      + +

      图 1 展示了发布流程在整个 Android 应用开发流程中所处的位置。一般来说，您要先在调试环境中完成对应用的测试，然后再执行发布流程。此外，在开始发布流程之前，您最好确保应用符合针对功能、性能和稳定性的所有发布标准。

      + +展示了发布流程在整个开发流程中所处的位置 +

      + 图 1. 发布是 Android 应用开发流程中的最后一个阶段。 +

      + +

      准备应用以进行发布

      + +

      发布之前的准备过程涉及多个步骤，需要您完成以下任务：

      + +
        +
      • 配置应用以进行发布。 +

        您至少需要从清单文件中移除 Log 调用和 android:debuggable 属性，还应为 android:versionCode 和 android:versionName 属性（位于 <manifest> 元素中）提供值。此外，您还可能需要配置多项其他设置，以符合 Google Play 的发布要求，或者符合其他应用发布方式的要求。

        +
        • +
      • 构建应用的发布版本并签名。 +

        Android SDK 工具中随附的 Android Development Tools (ADT) 插件和 Ant 构建脚本可向您提供构建应用的发布版本并签名所需的全部信息。

        +
        • +
      • 测试应用的发布版本。 +

        在分发应用之前，您至少应在一部适配的手机和一台适配的平板电脑上全面测试应用的发布版本。

        +
        • +
      • 更新应用资源以进行发布。 +

        您需确保所有应用资源（例如多媒体文件和图形）都是最新的，且已包含在应用中或者已存储到正确的生产服务器上。

        +
        • +
      • 准备应用所依赖的远程服务器和服务。 +

        如果您的应用依赖于外部服务器或服务，您要确保这些服务器或服务是安全的，随时可投入实际使用。

        +
        • +
      + +

      在准备阶段，您可能还需要执行其他一些任务。例如，您需要获取私钥来为应用签名；如果您使用 Google 地图外部库，则需要获取 Maps API 发布密钥。此外，您还需要为应用创建一个图标，而且可能需要准备最终用户许可协议 (EULA) 以保护您的员工、公司和知识产权。

      + +

      当您完成发布应用所需的准备工作之后，您将得到一个已签名的 .apk 文件，可以将文件分发给用户。

      + +

      要了解如何准备应用以进行发布，请参阅开发者指南中的准备发布。这篇文章提供了有关如何配置和构建应用的发布版本的分步说明。

      + +

      向用户发布应用

      + +

      您可以通过多种方式发布您的 Android 应用。通常情况下，您通过 Google Play 等应用市场发布应用，但您也可以在自己的网站上发布应用或直接将应用发送给用户。 + +

      通过应用市场发布应用

      + +

      如果您希望向尽可能多的目标用户分发应用，最好通过 Google Play 等应用市场发布应用。

      + +

      Google Play 是 Android 应用的主要市场，它尤其适合向遍布全球的众多目标用户分发您的应用。不过，您也可以通过自己喜欢的其他应用市场分发您的应用，也可以在多个市场中分发。

      + + +

      在 Google Play 上发布应用

      + +

      Google Play 是一个强大的应用发布平台，可帮助您向全球用户宣传、销售和分发您的 Android 应用。当通过 Google Play 发布应用时，您可以使用一系列开发者工具，分析您的销售数据、了解市场趋势以及控制向哪些用户分发应用。此外，您还能使用多种有助您增加收入的功能，如应用内结算和应用许可。丰富的工具和功能，以及为数众多的最终用户社区功能，让 Google Play 成为销售和购买 Android 应用的主要平台。

      + +

      在 Google Play 上发布应用相当简单，只需三个基本步骤：

      + +
        +
      • 准备宣传材料。 +

        为了充分利用 Google Play 的营销和宣传功能，您需要为应用制作宣传材料，例如屏幕截图、视频、图形以及宣传文字。

        +
        • +
      • 配置选项并上传资源。 +

        利用 Google Play，您可以将应用定位到全球的用户和设备。通过配置各种 Google Play 设置，您可以选择要覆盖的国家/地区、要使用的商品详情语言以及应用在各个国家/地区的价格。此外，您还可以配置商品详情，例如应用类型、类别和内容分级。配置各种选项之后，您可以上传宣传材料和草稿版（未发布的）应用。

        +
        • +
      • 发布应用的发布版本。 +

        如果您确认各项发布设置均配置正确，而且您上传的应用可以公开发布，只需点击开发者控制台中的发布即可。在几分钟之内，您的应用就会发布到网络上供全球用户下载。

        +
        • +
      + +

      如需了解完整信息，请访问 Google Play。

      + + +

      通过电子邮件发布应用

      + +
      + 此屏幕截图展示了用户在收到您发送的应用时看到的图形界面 +

      + 图 1. 当您通过电子邮件向用户发送应用时，用户只需点击安装即可。 +

      +
      + +

      最简单快捷的应用发布方式就是通过电子邮件将应用发送给用户。为此，您需要准备好应用的发布版本，将其添加为电子邮件的附件，然后发送给用户。当用户在其 Android 设备上打开您的电子邮件时，Android 系统会识别出该 APK 并在电子邮件中显示立即安装按钮（参见图 1）。用户触摸该按钮即可安装您的应用。

      + +

      注意：只有当用户将其设备配置为允许安装来自未知来源的应用且通过本机的 Gmail 应用打开您的电子邮件时，才会出现图 1 所示的立即安装按钮。

      + +

      如果您只将应用发送给几位受信任的用户，那么通过电子邮件分发就非常方便。不过，这种发布方式不利于阻止盗版和未经授权的分发，也就是说，收到您应用的任何人都可以将应用转发给其他人。

      + +

      通过网站发布应用

      + +

      如果您不想在 Google Play 这样的市场上发布应用，则可以将应用放在您的网站或服务器（包括私人服务器或企业服务器）上供用户下载。为此，您必须先按正常流程准备好应用的发布版本，然后您只需将准备好的 APK 文件托管到网站上并向用户提供下载链接即可。 +

      + +

      当用户在其 Android 设备上访问该下载链接时，文件就会开始下载，Android 系统会在下载完成后自动将应用安装到设备上。不过，只有当用户将其“设置”配置为允许安装来自未知来源的应用时，安装进程才会自动启动。

      + +

      虽然在您的网站上发布应用相对比较简单，但效率可能并不高。例如，如果您想通过自己的应用获利，则必须自行处理和跟踪所有财务交易且不能使用 Google Play 的应用内结算服务来销售应用内商品。此外，您也不能使用许可服务来阻止他人未经授权安装和使用您的应用。

      + + +

      用户选择安装来自未知来源的应用

      + +
      + 此屏幕截图展示了用于接受从未知来源下载和安装应用的设置 +

      + 图 2. 用户必须启用未知来源设置，才能安装从 Google Play 以外的位置下载的应用。 +

      +
      + +

      Android 可防止用户无意中从 Google Play（受信任的市场）以外的位置下载并安装应用。只要用户未启用“设置”>“安全”下的未知来源（如图 2 所示），它就会阻止此类安装。要允许安装来自其他来源的应用，用户必须在其设备上启用“未知来源”设置，且必须先更改此项配置才能将您的应用下载到设备上。

      + +

      请注意，部分网络提供商不允许用户安装来自未知来源的应用。

      diff --git a/docs/html-intl/intl/zh-cn/training/basics/fragments/fragment-ui.jd b/docs/html-intl/intl/zh-cn/training/basics/fragments/fragment-ui.jd new file mode 100644 index 0000000000000..51a4e278e5bc3 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/training/basics/fragments/fragment-ui.jd @@ -0,0 +1,139 @@ +page.title=构建灵活的界面 +trainingnavtop=true +page.type=培训 +@jd:body + +
      +
      +

      本课程所教授的内容：

      +
        +
      1. 在运行时向 Activity 添加 Fragment
        2. +
      2. 用一个 Fragment 替换另一个 Fragment
        3. +
      + +

      你还应阅读以下内容：

      + + +

      试试以下示例：

      + +
      + 下载示例 +

      FragmentBasics.zip

      +
      + +
      +
      + + +

      在设计支持各种屏幕尺寸的应用时，你可以在不同的布局配置中重复使用 Fragment ，以便根据相应的屏幕空间提供更出色的用户体验。

      + +

      例如，一次只显示一个 Fragment 可能就很适合手机这种单窗格界面，但在平板电脑上，你可能需要设置并列的 Fragment，因为平板电脑的屏幕尺寸较宽阔，可向用户显示更多信息。

      + + +

      图 1： 两个 Fragment，显示在不同尺寸屏幕上同一 Activity 的不同配置中。在较宽阔的屏幕上，两个 Fragment 可并列显示；在手机上，一次只能显示一个 Fragment，因此必须在用户导航时更换 Fragment。

      + +

      利用 FragmentManager 类提供的方法，你可以在运行时添加、移除和替换 Activity 中的 Fragment，以便为用户提供一种动态体验。

      + + + +

      在运行时向 Activity 添加 Fragment

      + +

      你可以在 Activity 运行时向其添加 Fragment，而不用像上一课中介绍的那样，使用 <fragment> 元素在布局文件中为 Activity 定义 Fragment。如果你打算在 Activity 运行周期内更改 Fragment，就必须这样做。

      + +

      要执行添加或移除 Fragment 等事务，你必须使用 FragmentManager 创建一个 FragmentTransaction，后者可提供用于执行添加、移除、替换以及其他 Fragment 事务的 API。

      + +

      如果 Activity 中的 Fragment 可以移除和替换，你应在调用 Activity 的 onCreate() 方法期间为 Activity 添加初始 Fragment(s)。

      + +

      在处理 Fragment（特别是在运行时添加的 Fragment ）时，请谨记以下重要规则：必须在布局中为 Fragment 提供 View 容器，以便保存 Fragment 的布局。

      + +

      下面是上一课所示布局的替代布局，这种布局一次只会显示一个 Fragment。要用一个 Fragment 替换另一个 Fragment， Activity 的布局中需要包含一个作为 Fragment 容器的空 FrameLayout。

      + +

      请注意，该文件名与上一课中布局文件的名称相同，但布局目录没有 large 这一限定符。因此，此布局会在设备屏幕小于“large”的情况下使用，原因是尺寸较小的屏幕不适合同时显示两个 Fragment。

      + +

      res/layout/news_articles.xml:

      + 
      +    <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+        android:id="@+id/fragment_container"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent" />
+
      + +

      在 Activity 内部，使用 Support Library API 调用 getSupportFragmentManager() 以获取 FragmentManager，然后调用 beginTransaction() 创建 FragmentTransaction，同时调用 add() 添加 Fragment。

      + +

      你可以使用同一个 FragmentTransaction 对 Activity 执行多 Fragment 事务。当你准备好进行更改时，必须调用 commit()。

      + +

      例如，下面介绍了如何为上述布局添加 Fragment ：

      + + 
      +    import android.os.Bundle;
+    import android.support.v4.app.FragmentActivity;
+
+    public class MainActivity extends FragmentActivity {
+        &Override
+        public void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+            setContentView(R.layout.news_articles);
+
+            // 确认 Activity 使用的布局版本包含
+            // fragment_container FrameLayout
+            if (findViewById(R.id.fragment_container) != null) {
+
+                // 不过，如果我们要从先前的状态还原，
+                // 则无需执行任何操作而应返回
+                // 否则就会得到重叠的 Fragment 。
+                if (savedInstanceState != null) {
+                    return;
+                }
+
+                // 创建一个要放入 Activity 布局中的新 Fragment 
+                HeadlinesFragment firstFragment = new HeadlinesFragment();
+
+                // 如果此 Activity 是通过 Intent 发出的特殊指令来启动的，
+                // 请将该 Intent 的 extras 以参数形式传递给该 Fragment 
+                firstFragment.setArguments(getIntent().getExtras());
+
+                // 将该 Fragment 添加到“fragment_container”FrameLayout 中
+                getSupportFragmentManager().beginTransaction()
+                        .add(R.id.fragment_container, firstFragment).commit();
+            }
+        }
+    }
+
      + +

      由于该 Fragment 已在运行时添加到 FrameLayout 容器中，而不是在 Activity 布局中通过 <fragment> 元素进行定义，因此该 Activity 可以移除和替换这个 Fragment 。

      + + + +

      用一个 Fragment 替换另一个 Fragment

      + +

      替换 Fragment 的步骤与添加 Fragment 的步骤相似，但需要调用 replace() 方法，而非 add()。

      + +

      请注意，当你执行替换或移除 Fragment 等 Fragment 事务时，最好能让用户向后导航和“撤消”所做更改。要通过 Fragment 事务允许用户向后导航，你必须调用 addToBackStack()，然后再执行 FragmentTransaction。

      + +

      注意：当你移除或替换 Fragment 并向返回堆栈添加事务时，已移除的 Fragment 会停止（而不是销毁）。如果用户向后导航，还原该 Fragment，它会重新启动。如果你没有向返回堆栈添加事务，那么该 Fragment 在移除或替换时就会被销毁。

      + +

      替换 Fragment 的示例：

      + + 
      +    // 创建 Fragment 并为其添加一个参数，用来指定应显示的文章
+    ArticleFragment newFragment = new ArticleFragment();
+    Bundle args = new Bundle();
+    args.putInt(ArticleFragment.ARG_POSITION, position);
+    newFragment.setArguments(args);
+
+    FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
+
+    // 将 fragment_container View 中的内容替换为此 Fragment ，
+    // 然后将该事务添加到返回堆栈，以便用户可以向后导航
+    transaction.replace(R.id.fragment_container, newFragment);
+    transaction.addToBackStack(null);
+
+    // 执行事务
+    transaction.commit();
+
      + +

      addToBackStack() 方法可接受可选的字符串参数，来为事务指定独一无二的名称。除非你打算使用 FragmentManager.BackStackEntry API 执行高级 Fragment 操作，否则无需使用此名称。

      + diff --git a/docs/html-intl/intl/zh-cn/training/monitoring-device-state/index.jd b/docs/html-intl/intl/zh-cn/training/monitoring-device-state/index.jd index aa107539eeca5..308ad7b8a9f52 100644 --- a/docs/html-intl/intl/zh-cn/training/monitoring-device-state/index.jd +++ b/docs/html-intl/intl/zh-cn/training/monitoring-device-state/index.jd @@ -1,5 +1,5 @@ page.title=优化电池使用时间 - +page.type=培训 trainingnavtop=true startpage=true next.title=监控电池电量和充电状态 diff --git a/docs/html-intl/intl/zh-cn/training/multiscreen/index.jd b/docs/html-intl/intl/zh-cn/training/multiscreen/index.jd index 3514bd691322e..02c687aaaef82 100644 --- a/docs/html-intl/intl/zh-cn/training/multiscreen/index.jd +++ b/docs/html-intl/intl/zh-cn/training/multiscreen/index.jd @@ -1,5 +1,5 @@ page.title=针对多种屏幕进行设计 - +page.type=培训 trainingnavtop=true startpage=true next.title=支持各种屏幕尺寸 diff --git a/docs/html/design/design_toc.cs b/docs/html/design/design_toc.cs index 52c7c52d6c82a..416a93d16a2bb 100644 --- a/docs/html/design/design_toc.cs +++ b/docs/html/design/design_toc.cs @@ -51,7 +51,7 @@
    • Color
    • Iconography
    • Your Branding
      • -
    • Writing Style
      • +
    • Writing Style
      • diff --git a/docs/html/distribute/essentials/essentials_toc.cs b/docs/html/distribute/essentials/essentials_toc.cs index 985809a4dc798..0369d4dea7c76 100644 --- a/docs/html/distribute/essentials/essentials_toc.cs +++ b/docs/html/distribute/essentials/essentials_toc.cs @@ -1,11 +1,11 @@