license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations

under the License.

Android プラットフォーム ガイド

このガイドは、Android デバイスのための Cordova アプリを展開する SDK 環境を設定する方法と必要に応じて開発ワークフローでアンドロイドを中心のコマンド ライン ツールを使用する方法を示します。 開発のためこれらのプラットフォームを中心としたシェル ツールまたはクロス プラットフォーム コルドバ CLI を使用するかどうかに関係なく Android SDK をインストールする必要があります。 2 つの開発パスの比較の概要を参照してください。 CLI の詳細は、コマンド ライン インターフェイスを参照してください。

要件、およびサポート

人造人間のためのコルドバ OS X、Linux または Windows のオペレーション システムにインストールされている可能性がありますが人造人間 SDK が必要です。 Android の SDK のシステム要件を参照してください。.

コルドバ (Android の API レベル 14 で始まる) アンドロイド 4.0.x をサポートしているより高い。 一般的な規則として Google の分布のダッシュ ボード上の 5% を下回ると Android のバージョンになるコルドバでサポートされていません。 アンドロイド バージョン API より早くレベル 10、および 3.x バージョン (ハニカム、API レベル 11-13) はその 5 ％ のしきい値を大きく下回ったことができます。

コルドバ シェル ツールをインストールします。

SDK と一緒にコルドバのアンドロイドを中心のシェル ・ ツールを使用する場合はcordova.apache.orgからコルドバをダウンロードします。 コマンド ライン インターフェイスで記述されているクロス プラットフォーム CLI ツールを使用する予定がある場合それ以外の場合このセクションを無視します。

コルドバ ダウンロードには、プラットフォームごとに別々 のアーカイブが含まれています。 適切なアーカイブを展開してください android この場合、空のディレクトリ内。 関連性の高い実行ユーティリティは、トップレベルで利用可能な bin ディレクトリ。 (より詳細な指示が必要な場合は、 READMEファイルを参照して)。

これらのシェルのツールを作成、構築、および Android アプリを実行することができます。 すべてのプラットフォームのプラグイン機能を有効にする追加のコマンド ライン インターフェイスについては、管理プラグインを使用して Plugman を参照してください。 プラグインを開発する方法の詳細については、アプリケーション ・ プラグインを参照してください。

Java 開発キット (JDK) のインストールします。

Java 開発キット (JDK) 7をインストールまたはそれ以降。

Windows をインストールするときも JDK インストール パス (たとえば、C:\Program Files\Java\jdk1.7.0_75) によるとJAVA_HOME環境変数を設定する必要があります。

Android の SDK をインストールします。

Android のスタンドアロン SDK ツールやAndroid のスタジオをインストールします。 Procceed 対応アンドロイド Studioプラグインのアンドロイド新しいコルドバの開発またはネイティブ ツールを使用して実行および Android プラットフォームをデバッグする場合。 それ以外の場合は、 Android のスタンドアロン SDK ツールは Android アプリケーション ビルドおよび配置するのに十分です。

詳細なインストール手順は利用可能な上記のリンクをインストールの一部として。

コルドバするために、コマンド ライン ツールまたはに基づいては、CLI は、SDK のツールやプラットフォーム固有のツールディレクトリパスに含める必要があります。 Mac では、テキスト エディターを使用して、作成または SDK のインストールに応じて、次のような行を追加する~/.bash_profileファイルを変更することができます。

    export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools

~/.Bash_profile内のこの行は、新しくオープンしたターミナル ウィンドウでこれらのツールを公開します。 ターミナル ・ ウィンドウをまだ開いて場合は osx 版、またはログアウト/ログイン Linux 上を避けるために、現在の端末ウィンドウで使用できるようにするこれを実行します。

    $ source ~/.bash_profile

Windows のPATH環境を変更: する

  1. デスクトップの左下隅の [スタート] メニューをクリックして、コンピューターを右クリックして ［プロパティ］.

  2. 左側の列では、システムの詳細設定を選択します。

  3. 表示されたダイアログ ボックスで環境変数キーを押します。.

  4. パス変数を選択し、キーを押して編集.

  5. 追加するのには、次の PATH 例えば、SDK をインストールしたに基づきます。

    ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools

  6. 値を保存して両方のダイアログ ボックスを閉じます。

SDK パッケージをインストールします。

アンドロイド SDK マネージャーを開く (たとえば、端末を介して:アンドロイド) インストールと。

  1. アンドロイド 5.1.1 (API 22) プラットフォーム SDK
  2. Android の SDK ビルド ツール バージョン 19.1.0 またはそれ以降
  3. Android 対応リポジトリ (エクストラ)

詳細については、 SDK パッケージのインストールを参照してください。

エミュレーターを構成します。

人造人間 sdk は既定で任意の既定のエミュレーターのインスタンスを提供しません。 コマンド ・ ラインでandroidを実行して新しいものを作成できます。 プレスツール → 管理 Avd (Android 仮想デバイス)、デバイスの定義されたダイアログ ボックスから任意の項目を選択します。

プレスAVD の作成、必要に応じて、名前の変更、変更を受け入れて**[ok]**を押します。

これで、AVD Android 仮想デバイスリストに表示されます。

エミュレーターを開くには、個別のアプリケーションとして、AVD を選択し、開始を押します。ハードウェア ボタンで使用できるコントロールを追加して、デバイスのように多くを起動します。

高速な経験のため、実行速度を向上させる仮想マシン加速を使用できます。 多くの近代的な Cpu をより効率的に仮想マシンを実行する拡張機能を提供します。 加速度のこのタイプを使用する前にかどうか、現在の開発システムの CPU をサポートしています 1 つ次の仮想化テクノロジを決定する必要があります。

  • インテル バーチャライゼーション ・ テクノロジー(VT-x、vmx) → Intel VT-x 対応のプロセッサ一覧
  • AMD の仮想化AMD-V （SVM）、Linux のサポートだけ (2006 年 5 月以来すべての Cpu AMD を含める AMD-V Sempron を除く)。

かどうか、インテル ・ プロセッサーの VT-x テクノロジをサポートする、インテル プロセッサー識別ユーティリ ティーを実行している、インテル・ ダウンロード ・ センターからダウンロードできますwindowsやOS に依存しないであるbooteable ユーティリティを使用することができますを調べる別の方法.

インストールし、インテルのプロセッサー識別ユーティリ ティーを実行後、Windows 上あなたの CPU 仮想化テクノロジをサポートしているかどうかを確認するために次のウィンドウを得るでしょう：

エミュレーターをスピードアップするためにダウンロードし、1 つ以上のIntel x86 原子システム イメージとしてインテル ハードウェア加速実行マネージャー (HAXM)をインストールする必要があります。.

あなたアンドロイド SDK マネージャーを開き、テストするどちらかのバージョンのIntel x86 原子システム イメージを選択します。 エクストラに行くとIntel x86 エミュレーター アクセラレータ (HAXM)を選択し、それらのパッケージをインストールします。

ダウンロード後エクストラ/インテル/Hardware_Accelerated_Execution_Managerでアンドロイド SDK で提供されているインテル インストーラーを実行します。 注:より多くの情報とステップ バイ ステップ ガイダンスこのチェックを見つけることができる場合は、パッケージのインストールに問題がある Intel の記事.

  1. 1 つ以上のIntel x86 原子システム イメージとして、インテル ハードウェア加速実行マネージャー、余分な物の下で利用可能なインストールします。.

  2. エクストラ/インテル/Hardware_Accelerated_Execution_Managerでアンドロイド SDK で提供されているインテルのインストーラーを実行します。.

  3. インテル画像に設定されているターゲットで新しい AVD を作成します。

  4. エミュレーターを起動するときはハックス モジュールのロードに失敗を示すエラー メッセージがない確認します。

新しいプロジェクトを作成します。

この時点で、新しいプロジェクトを作成する、コマンド ライン インターフェイスまたは人造人間固有のシェルのツールのセットで説明するクロス プラットフォーム CLI ツールの間に選択できます。 ソース コード ディレクトリ内からの場合、CLI アプローチここです：

    $ cordova create hello com.example.hello HelloWorld
    $ cd hello
    $ cordova platform add android
    $ ccordova prepare              # or "cordova build"

ここでは Unix および Windows の対応する低レベル シェル ツール アプローチ：

    $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld
    C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld

プロジェクトをビルドします

開発で CLI を使用している場合、プロジェクトの最上位レベルのwwwディレクトリにはソース ファイルが含まれます。アプリを再構築するには、プロジェクト ディレクトリ内のこれらのいずれかを実行します。

    $ cordova build                   # build all platforms that were added
    $ cordova build android           # build debug for only Android
    $ cordova build android --debug   # build debug for only Android
    $ cordova build android --release # build release for only Android

開発で人造人間に固有のシェルのツールを使用している場合、別のアプローチがあります。 プロジェクトを生成した後、既定のアプリのソースは資産/wwwサブディレクトリで利用可能です。 以降のコマンドはそのコルドバサブディレクトリで利用できます。

ビルドコマンドをプロジェクト ファイルを消去して、アプリを再構築します。ここでは、Mac と Windows の両方の構文です。 例の最初のペアを生成するデバッグ情報と 2 番目のリリースのアプリを構築します。

    $ /path/to/project/cordova/build --debug
    C:\path\to\project\cordova\build.bat --debug

    $ /path/to/project/cordova/build --release
    C:\path\to\project\cordova\build.bat --release

アプリを展開します。

コルドバCLI ユーティリティを使用して、コマンド ・ ラインから、エミュレーターまたはデバイスにアプリケーションを配置することができます。

    $ cordova emulate android       #to deploy the app on a default iOS emulator
    $ cordova run android --device  #to deploy the app on a connected device

それ以外の場合は、代替シェル インターフェイスを使用します。

    $ /path/to/project/cordova/run --emulator
    $ /path/to/project/cordova/run --device

使用することができますcordova run android --listを見るすべての利用可能なターゲットとcordova run android --target=target_name 、特定のデバイスまたはエミュレーターでアプリケーションを実行する (たとえば、cordova run android --target="Nexus4_emulator").

コルドバの実行 - ヘルプを使用して、追加のビルドを参照してください、オプションを実行することもできます。

これは、ホーム画面にアプリをプッシュし、それを起動します。

ときにアプリを実行を構築することもそれ。 追加を追加することができます--デバッグ、 -リリース、および構築方法や、再構築が必要かどうかも制御する--nobuildフラグ。

    $ /path/to/project/cordova/run --emulator --nobuild

その他のコマンド

実行時のアプリケーションの詳細なログを生成します。

    $ /path/to/project/cordova/log
    C:\path\to\project\cordova\log.bat

次のプロジェクト ファイルが消去されます。

    $ /path/to/project/cordova/clean
    C:\path\to\project\cordova\clean.bat

SDK で新しいプロジェクトを開く

Android プラットフォームは、プロジェクトに追加されます、一度Android Studio内からそれを開くことができます。

  1. アンドロイド Studioアプリケーションを起動します。

  2. **インポート プロジェクト (Eclipse ADT、Gradle など)**を選択します.

  3. Android プラットフォームは、ストアドあなた/プロジェクト/プラットフォーム/androidの場所を選択します。).

  4. Gradle 同期質問の単に答えがはい.

あなたを構築し、 Android のスタジオから直接アプリケーションを実行することができますすべての現在設定されて.

Android のスタジオの概要を参照してください、そして建物と Android Studio から実行する詳細については。