Android Native Activity アプリの作成Create an Android Native Activity App

Visual C++ for Cross-Platform Mobile Development オプションをインストールすると、Visual Studio 2015 を使用して、フル機能を持つ Android Native Activity アプリを作成できます。When you install the Visual C++ for Cross-Platform Mobile Development option, Visual Studio 2015 can be used to create fully functional Android Native Activity apps. Android Native Development Kit (NDK) は、純粋な C/C++ コードを使用して Android アプリの大半を実装することを可能にするツールセットです。The Android Native Development Kit (NDK) is a toolset that allows you to implement the majority of your Android app using pure C/C++ code. いくつかの Java JNI コードはグルーとして機能し、C/C++ コードが Android とやり取りできるようにします。Some Java JNI code acts as glue to allow your C/C++ code to interact with Android. Android NDK では、Android API レベル 9 を使用して Native Activity アプリを作成する機能が導入されました。The Android NDK introduced the ability to create Native Activity apps with Android API Level 9. Native Activity コードは、Unreal Engine または OpenGL を使用したゲームやグラフィックス処理の多いアプリを作成できるので人気があります。Native Activity code is popular for creating gaming and graphic intensive apps that use Unreal Engine or OpenGL. このトピックでは、OpenGL を使用した単純な Native Activity アプリの作成方法について説明します。This topic will guide you through creation of a simple Native Activity app that uses OpenGL. 他のトピックでは、Native Activity コードの編集、ビルド、デバッグ、展開の開発ライフサイクルについて説明します。Additional topics walk through the developer lifecycle of editing, building, debugging and deploying Native Activity code.

必要条件 Requirements
新しいネイティブ アクティビティ プロジェクトを作成する Create a new Native Activity project
既定の Android Native Activity アプリをビルドして実行するBuild and run the default Android Native Activity app

必要条件Requirements

Android Native Activity アプリを作成する前に、すべてのシステム要件を満たし、Visual Studio 2015 の Visual C++ for Cross-Platform Mobile Development をインストールしていることを確認します。Before you can create an Android Native Activity app, you must make sure you've met all system requirements, and installed the Visual C++ Mobile Development option in Visual Studio 2015. 詳細については、「 Install Visual C++ for Cross-Platform Mobile Development」を参照してください。For more information, see Install Visual C++ for Cross-Platform Mobile Development. インストールに必要なサード パーティのツールと SDK が含まれていること、また Microsoft Visual Studio Emulator for Android がインストールされていることを確認してください。Make sure that the required third-party tools and SDKs are included in the installation, and that the Microsoft Visual Studio Emulator for Android is installed.

新しいネイティブ アクティビティ プロジェクトを作成するCreate a new Native Activity project

このチュートリアルでは、まず新しい Android Native Activity プロジェクトを作成します。それから、既定のアプリを Visual Studio Emulator for Android でビルドして実行します。In this tutorial, you'll first create a new Android Native Activity project and then build and run the default app in the Visual Studio Emulator for Android.

新しいプロジェクトを作成するにはTo create a new project

  1. Visual Studio を開きます。Open Visual Studio. メニュー バーで [ファイル][新規][プロジェクト]の順にクリックします。On the menu bar, choose File, New, Project.

  2. [新しいプロジェクト] ダイアログ ボックスの [テンプレート][Visual C++][Cross Platform]の順に選択し、 [Native-Activity Application (Android)] テンプレートを選択します。In the New Project dialog box, under Templates, choose Visual C++, Cross Platform, and then choose the Native-Activity Application (Android) template.

  3. アプリケーションに MyAndroidApp のような名前を付けてから、[OK] をクリックします。Give the app a name like MyAndroidApp, and then choose OK.

    Native Activity プロジェクトの作成Create a Native Activity project

    Visual Studio は新しいソリューションを作成し、ソリューション エクスプローラーを開きます。Visual Studio creates the new solution and opens Solution Explorer.

    ソリューション エクスプローラーでの Native Activity プロジェクトNative Activity project in Solution Explorer

    新しい Android Native Activity アプリのソリューションには、次の 2 つのプロジェクトが含まれています。The new Android Native Activity app solution includes two projects:

  • MyAndroidApp.NativeActivity には、アプリが Android 上でネイティブ アクティビティとして動作するための参照とグルー コードが含まれています。MyAndroidApp.NativeActivity contains the references and glue code for your app to run as a Native Activity on Android. グルー コードからのエントリ ポイントの実装は main.cpp にあります。The implementation of the entry points from the glue code are in main.cpp. プリコンパイル済みヘッダーは pch.h にあります。Precompiled headers are in pch.h. この Native Activity アプリ プロジェクトは、共有ライブラリ (.so) ファイルにコンパイルされ、Packaging プロジェクトで使用されます。This Native Activity app project is compiled into a shared library .so file which is picked up by the Packaging project.

  • MyAndroidApp.Packaging は、Android デバイスまたはエミュレーターに配置する .apk ファイルを作成します。MyAndroidApp.Packaging creates the .apk file for deployment on an Android device or emulator. これには、リソースと、マニフェスト プロパティを設定する AndroidManifest.xml ファイルが含まれています。This contains the resources and AndroidManifest.xml file where you set manifest properties. Ant のビルド プロセスを制御する build.xml も含まれています。It also contains the build.xml file that controls the Ant build process. それは既定でスタートアップ プロジェクトとして設定されているため、Visual Studio から直接、配置して実行できます。It's set as the startup project by default, so that it can be deployed and run directly from Visual Studio.

既定の Android Native Activity アプリをビルドして実行するBuild and run the default Android Native Activity app

テンプレートによって生成されたアプリをビルドして実行し、インストールとセットアップを確認します。Build and run the app generated by the template to verify your installation and setup. この初期テストでは、Visual Studio Emulator for Android によってインストールされるデバイス プロファイルのいずれかでアプリを実行します。For this initial test, run the app on one of the device profiles installed by the Visual Studio Emulator for Android. 別の対象でアプリをテストする場合は、対象のエミュレーターを読み込むか、デバイスをコンピューターに接続してください。If you prefer to test your app on another target, you can load the target emulator or connect the device to your computer.

既定の Native Activity アプリをビルドして実行するにはTo build and run the default Native Activity app

  1. 選択されていない場合は、 [ソリューション プラットフォーム] ドロップダウン リストから [x86] を選択します。If it is not already selected, choose x86 from the Solution Platforms dropdown list.

    ソリューション プラットフォーム ドロップダウン x86 の選択Solution Platforms dropdown x86 selection

    [ソリューション プラットフォーム] リストが表示されない場合は、[ボタンの追加と削除] リストから [ソリューション プラットフォーム] を選択してから、使用するプラットフォームを選択します。If the Solution Platforms list isn't showing, choose Solution Platforms from the Add/Remove Buttons list, and then choose your platform.

  2. メニュー バーの [ビルド][ソリューションのビルド]の順にクリックします。On the menu bar, choose Build, Build Solution.

    ソリューションに含まれる 2 つのプロジェクトのビルド プロセスの出力が [出力] ウィンドウに表示されます。The Output window displays the output of the build process for the two projects in the solution.

  3. 配置ターゲットとして、いずれかの VS Emulator Android Phone (x86) プロファイルを選択します。Choose one of the VS Emulator Android Phone (x86) profiles as your deployment target.

    別のエミュレーターをインストールしてあるか、Android デバイスを接続してある場合は、配置対象のドロップダウン リストからそれらを選択できます。If you have installed other emulators or connected an Android device, you can choose them in the deployment target dropdown list.

  4. F5 キーを押してデバッグを開始するか、Shift キーを押しながら F5 キーを押してデバッグなしで開始します。Press F5 to start debugging, or Shift+F5 to start without debugging.

    Visual Studio Emulator for Android で、既定のアプリは次のようになります。Here's what the default app looks like in the Visual Studio emulator for Android.

    アプリを実行するエミュレーターThe emulator running your app

    Visual Studio によってエミュレーターが起動されます。コードを読み込んで配置するのに数秒かかります。Visual Studio starts the emulator, which takes a few seconds to load and deploy your code. アプリが開始されると、ブレークポイントの設定や、デバッガーを使用したステップ実行、ローカルの確認、値のウォッチができるようになります。Once your app has started, you can set breakpoints and use the debugger to step through code, examine locals, and watch values.

  5. Shift キーを押しながら F5 キーを押してデバッグを停止します。Press Shift + F5 to stop debugging.

    エミュレーターは実行され続ける独立したプロセスです。The emulator is a separate process that continues to run. 同じエミュレーターに対して、コードを何度も編集、コンパイル、配置できます。You can edit, compile, and deploy your code multiple times to the same emulator.