トップ | リロード | 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ

Android Studio について †

2014年12月9日から、Eclipseベースの、Android Developer Tools（ADT）から、Android Studio 1.0 に切り替わった。元は IntelliJ IDEA を元にし、Android SDK やエミュレータなども自動インストールされる。現在 1.1

Android SDK & NDK について †

SDKは基本的に、Studioをインストール時に一緒にインストールされるため、特に問題はないが、NDKは別途 Android NDK のファイルをダウンロード時し、任意の場所に展開後、プロジェクト直下のlocal.propertiesに以下のように追加する。（自動インストールされたSDKの場所はここで確認もできる。）

sdk.dir=/Users/yuki/Library/Android/sdk
ndk.dir=/Users/yuki/Documents/android-ndk-r10d   <- 追加

AndroidStudio 1.4ぐらいから ndk を自動でダウンロードしてくれるようになりました。 †

AndroidStudioを起動し、プロジェクトの app フォルダ右クリックし、Open Module Settingダイアログを開き、SDK Locationタブを選択します。そこで Android SDK Location の下にある、Download Android NDKをクリックします。但しすでに ndkがダウンロードされている場合には、ndk パスだけが表示されます。

AndroidStudioの特徴 †

Gradle採用 †

この Android Studioをベースにした開発においては、Gradleというビルドシステムが利用される（Ant、Mavenなどと同じ）。これは元はJava用に開発されたものであり、他のビルドシステムなどと違い、Groovyというスクリプト言語によって記述できる。

Gradleの日本語ドキュメント

Gradleについて †

Gradleは、プロジェクトの直下に置かれる、build.gradleを参照しビルドが行われる。通常のコマンドでの利用では、プロジェクト直下で、gradle build と打つことで実行されるが、Android Studio 上では、build -> build project を行うことで実行できる。（ただし NDK のネイティブソースは、build だけではコンパイルされず、実行を指定して初めてコンパイルされる）

• Gradle Plugin User Guide
• Gradleの Android Plugin DSLリファレンス
• Androidのページでの説明
• Gradle本体の日本語リファレンス
• Groovyを知らない人のためのbuild.gradle読み書き入門

DSLとは、Domain Specific Languageの略

基本的な gradle設定について †

Android Studio 1.4以降では、プロジェクトの app を右クリックし、メニューから「Open Module Setting」を選択すると、なぜか「Project Structure」という名前（リンクとウィンドウ名が違う）のダイアログが開き、そこで gradleファイルの基本的な設定が行えます。

各フォルダと各ファイルの意味 †

プロジェクトのTOPフォルダには、下記のフォルダとファイルが並びます。

ファイルの方は、比較的修正が多くなると思われる。

appフォルダの意味（パッケージ・アプリケーション） †

プロジェクト直下にある、app フォルダ（上記で登場）は、別名パッケージやアプリケーションとも言われる。詳細は以下の通り。

※Proguard利用時の build.gradle の設定サンプル

android {
   buildTypes {
       release {                               <- リリースビルドにのみ適用
           runProguard true
           proguardFile file('../proguard-project.txt')
           proguardFile getDefaultProguardFile('proguard-android.txt')
       }
   }
}

srcフォルダ内の構造 †

この app/src フォルダの中には通常２つのフォルダしか存在しない

mainフォルダの構造（基本ソースセット＋Flavorタイプ） †

main 以下のフォルダとファイル構造は以下の通り。また同じ階層に flavorタイプのフォルダも作成される。

Android NDKについて †

jniフォルダにソースを置くだけで自動コンパイルされるため、android.mk などは必要無し。

NDKの設定について †

プロジェクトトップにある build.gradle に以下の指定が行える。

android.defaultConfig.ndk {
    moduleName 'xxx'                             <- libxxx.so をリンクする。
    ldLibs "dl", "log"                                 <- リンクするライブラリ
    stl "gnustl_shared"                             <- 生成するライブラリの種類
    abiFilters "armeabi", "armeabi-v7a"   <- CPUアーキテクチャの指定
}

また ndk で利用できる指定は以下のとおり。

ビルドタイプ毎の設定なら †

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
            debuggable false
            ndk {
                cFlags cFlags + " -DNDEBUG -DLOG_NDEBUG"
            }
        }
        debug {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
            debuggable true　
            ndk {
               debuggable = true        <- デバッグの場合は/初期値
            }
        }
    }
}

このように、ビルドタイプ毎に ndk オプションを設定することが可能。debuggable = true が無いと、build type isn't JNI debuggable　というエラーがでる。

発売元別（アプリＩＤや証明書のみ違うバージョン作成） †

productFlavors {
    hoge {
        applicationId = 'com.gamvaro.hoge'
        signingConfig signingConfigs.hoge
    }
    fuga {
        applicationId = 'com.gamvaro.fuga'
        signingConfig signingConfigs.fuga
    }
}

複数のインクルードパスを追加したい場合。 †

gradleの文法における文字列結合を利用する。

ndk {
    cFlags = "-I${project.buildDir}/../src/main/jni/prj1" +
             "-I${project.buildDir}/../src/main/jni/prj2"
}

※注意、文字の後ろの文字結合を表す＋記号は、文字の後ろに記入すること。

フォルダ構成 †

Studioでは、ADTと違いフォルダ構成に大きな変更が入っている。以前の ADTにおけるプロジェクトでは、通常 projectフォルダ直下に、jni フォルダを作成しそこに、Android.mk を設置することで、ndk-build が自動的にそのフォルダ内の Android.mk を参照していたが、Studio では 下記の場所に移動している。（詳細は上記参照）

Project Top
  + app
     + src
        + main
           + java
           + jni
           + jniLibs
              + armeabi
              + armeabi-v7a
              + mips
              + x86
           + res
           + assets

ようするに上位に、app と src と main というフォルダ階層が増え、その下に ADT の頃のフォルダが並ぶ。

jniLibs のフォルダ名を変更する場合は、以下の行を追加する。

android {
   sourceSets.main {                  <- この main といのは 
       jniLibs.srcDir 'libs'
   }
}

sourceSetの他の項目 †

自動的に”src/{sourceSet_name}/”にSourceSetsが作成されます。フォルダの初期値を変更したい場合に利用する。※上項のように sourceSet_name（この場合main、mainは共通の部分）を個別に指定する事も可能

作成された so ファイルの場所 †

<project_folder>/app/build/intermediates/ndk/debug/lib

この下に各アーキテクチャ毎の so ファイルが作成される。

ndk-buildを、run のたびに実行させない方法 †

一度、ndk-build を通じて作成した、.so ファイルを、jniLibs フォルダにいれ、appフォルダ直下の build.gradle の jni ディレクトリの指定を空にすることで、今後の ndk-build は実行されなくなる。（但し、jniLibs の下はアーキテクチャー毎にフォルダがわかれるので、.so ファイルはアーキテクチャーに合わせて振り分ける）

android {
   sourceSets {
       main {
           jni.srcDirs = []      <- 空にする。
           jniLibs.srcDir "src/main/libs"
       }
   }
}

ちなみに内部的な android.mk（自動生成）は以下に作成される。

/app/build/intermediates/ndk/debug/Android.mk

CPUアーキテクチャーの指定 †

プロダクトに必要なものを指定

android {
   ProductFlavors {
	x86.ndk {
		abiFilter "x86"
	}
	x86_64.ndk {
		abiFilter "x86_64"
	}
	mips.ndk {
		abiFilter "mips"
	}
	mips64.ndk {
		abiFilter "mips64"
	}
	armv7.ndk {
		abiFilter "armeabi-v7a"
	}
	armv8.ndk {
		abiFilter "arm64-v8a"
	}
	arm.ndk {
		abiFilter "armeabi"
	}
   }
}

Androidのプロジェクトに外部ライブラリを導入する。 †

AndroidStudioでは、他のプロジェクトを参照する方法が存在しないため、プロジェクト内に外部ライブラリをモジュールという形で導入する。（例では libpng）

モジュール（外部ライブラリ）の作成 †

AndroidStudioでプロジェクトを作成後、メニューから、FILE -> New -> New Module と選択しモジュールの作成を指定すると、どのようなモジュールなのかの選択画面が表示されるので、ここで Android Library を指定する。

その後、モジュール名とライブラリ名を指定する。

Application Library Name : Lib PNG ver 1.6.19
Module Name : libpng

その後、プロジェクト作成時と同じ Activityの種類を指定するが、通常は必要ないので、no Activity を選択する。

Tips †

Gradleのバージョンアップ方法 †

Android Studioのプロジェクト内にある「app」フォルダを右クリックして、Open Module Settingsを選択します。するとダイアログが表示されるので、Projectタブを選択すると、右にGradle versionが表示されていますので、これを変更することで gradleのバージョンを変更できます。（例：2.4 -> 2.5）※その後Android StudioのWindows下にあるStatusエリアに、updateの情報が表示されます。

トラブルシューティング †

Neonが64bitで利用できない件

Error(13,0)が出た場合。 †

具体的には下記のようなエラーメッセージの場合。

NDK integration is deprecated in the current plugin.  Consider trying the new experimental plugin.  For details, see http://tools.android.com/tech-docs/new-build-system/gradle-experimental.  Set "android.useDeprecatedNdk=true" in gradle.properties to continue using the current NDK integration.

gradle.propertiesファイルに以下の行を追加

android.useDeprecatedNdk=true