IntelliJ IDEA 2020.3 ヘルプ

チュートリアル: 最初の Android アプリケーションを作成する

このチュートリアルでは、シンプルでありながら完全に機能する Android アプリケーションを作成し、ドロイドイメージをタップした回数をカウントします。その後、Android 仮想デバイスで実行します。

このチュートリアルでは、IntelliJ IDEA で Android 開発を始めるのに役立つ簡単なシナリオについて説明します。包括的な使い方ガイドとリファレンスドキュメントについては、Android Studio ユーザーガイドを参照してください。

新しい Android プロジェクトを作成する

プロジェクトの作成

  1. IntelliJ IDEA を起動します。ウェルカム画面で、新規プロジェクトをクリックします。すでにプロジェクトを開いている場合は、メインメニューからファイル | 新規 | プロジェクトを選択します。

  2. 新規プロジェクトウィザードで、左側の Android を選択します。

    Android SDK を構成していない場合、IntelliJ IDEA はこれを検出し、ダウンロードするように求めます。

    The New Project wizard: step one
  3. インストールするコンポーネントを選択します。以前に Android SDK ツールをインストールしたことがない場合は、必要なすべてのコンポーネントが事前に選択されています。

    必要に応じて、Android SDK の場所を変更し、次へをクリックします。

    The New Project wizard: step two
  4. インストール設定を確認し、完了をクリックしてダウンロードを開始します。

    The New Project wizard: step three

  5. すべてのコンポーネントをダウンロードしてインストールしたら、完了をクリックします。

    The New Project wizard: step four

  6. プロジェクトテンプレートとして空のアクティビティを選択します。

    The New Project wizard: step five

  7. 最後のステップで、プロジェクト名として HelloDroid を入力し、言語として Java を選択します。

    The New Project wizard: step six

プロジェクト JDK を構成する

最初のプロジェクトを作成したため、正しい JDK を使用していることを確認しましょう。

  1. メインメニューからファイル | プロジェクト構造を選択し、プラットフォーム設定 | SDK に移動します。Android SDK を選択し、Java SDK フィールドで正しい Java バージョンが選択されていることを確認します。

    Project Structure dialog

    IntelliJ IDEA での Android 開発には、Java SE 11 または Java SE 8 を使用することをお勧めします。正しい JDK がインストールされていない場合は、プロジェクト構造ダイアログで、ツールバーの新規 SDK の追加ボタンAdd New SDKをクリックし、JDK のダウンロードを選択します。

    Download JDK
  2. 設定 / 環境設定ダイアログ Ctrl+Alt+S で、ビルド、実行、デプロイ | ビルドツール | Gradle に移動し、正しい Java バージョン(8.x または 11.x)を選択します。

    Settings/Preferences dialog

プロジェクト構造を探索する

Android プロジェクトの場合、IntelliJ IDEA プロジェクトツールウィンドウに専用のビューがあります。左上隅のプロジェクトをクリックし、Android を選択します。

the Android project view

このビューは、ディスク上の実際のファイルの階層を反映していません。プロジェクトのソースファイル間のナビゲーションを容易にするために、モジュールとファイルタイプによって編成されています。通常は使用しないプロジェクトファイルとディレクトリを非表示にすることに注意してください(表示するには、プロジェクトビューを選択します)。

the Android project view

app フォルダーは、次のサブフォルダーで構成されています。

  • manifests :Android オペレーティングシステムによって処理されるアプリケーションに関する一般的な情報を保持する AndroidManifest.xml ファイルが含まれています。特に、アプリケーションの一意の識別子として機能するパッケージ名と、アプリケーションを実行するデバイスに必要な Android SDK の最小バージョンを宣言します。また、アプリケーションのエントリポイントと、アプリケーションに必要な権限も宣言します。詳細については、アプリマニフェストの概要を参照してください。

  • java :JUnit テストを含む、パッケージごとにグループ化された Java ソースコードファイルが含まれます。

  • res :XML レイアウトファイル、UI 文字列、イメージなど、すべての非コードリソースが含まれます。

Gradle スクリプトフォルダーには、プロジェクトのビルド関連の構成ファイルがすべて含まれています。

UI レイアウトを編集する

この段階では、サンプル HelloDroid アプリケーションのユーザーインターフェースは、res/layout フォルダーにある activity_main.xml ファイルで定義された非常にシンプルなレイアウトに基づいています。

自動生成されたユーザーインターフェースを変更して、物理または仮想デバイス上で実行せずにアプリケーションレイアウトがどのようにレンダリングされるかを見てみましょう。

UI デザイナーを開く

  1. Android プロジェクトビューで app/res/layout に移動し、activity_main.xml ファイルをダブルクリックして開きます。IntelliJ IDEA はレイアウトファイルのレンダリングに必要なコンポーネントをダウンロードするため、ファイルを開くには数秒かかる場合があります。

    デフォルトでは、IntelliJ IDEA はレイアウトファイルのグラフィックビューを提供しますが、ソースコードビューに切り替えたり、テキストとグラフィック表現を並べて表示したりすることもできます。UI デザイナペインの右上隅にあるアイコンを使用します:

    Android UI designer

    このペインには、レイアウト定義およびコンポーネントツリーと同期している長方形のキャンバスが表示されるため、キャンバスへの変更はすべてそれに応じて反映されます。

    通常、レイアウトファイルには、ルート要素としてレイアウトマネージャーがあります(たとえば、LinearLayoutFrameLayoutConstraintLayout など)。この例では、activity_main.xml のルート要素は ConstraintLayout であり、アプリケーションインターフェースの要素の配置を担当します。このチュートリアルでは、これを変更することはしませんが、ConstraintLayout でレスポンシブ UI を構築するからのインターフェースの設計について詳しく学ぶことができます。

  2. 煩わしさをなくし、レイアウトがどのように表現されているかだけを確認するには、左上隅にあるデザイン領域の選択アイコンをクリックして、デザインを選択します。

    The Select Design Surface button
  3. 次に、既存のテキスト要素を削除します。これを行うには、テキストラベルを右クリックし、コンテキストメニューから削除を選択します。

これで、UI レイアウトは次のようになり、アプリケーションのレイアウトの設計を開始する準備ができました。

Android UI designer pane

UI レイアウトにイメージを追加する

次に、ドロイドイメージをレイアウトに追加します。

  1. Android プロジェクトビューで、app/res フォルダーを展開し、使用するイメージを drawable フォルダーにドラッグします。このチュートリアルでは、インターネットからこんにちはドロイドイメージをダウンロードし、50x50 px のサイズで保存しました。

  2. デザイナーペインで開いた activity_main.xml ファイルに戻り、パレットから ImageView 要素を選択し、イメージを表示する位置までキャンバスにドラッグします。

  3. 開いたリソースの選択ダイアログで、追加したリソースファイルを選択し、OK をクリックします。

    Add image to Android layout

  4. 次に、後で参照できるように、imageView 要素のデフォルト ID を変更する必要があります。

    コンポーネントツリーおよび右側の属性ペインでそれを選択し、ID フィールドに新しい識別子を入力します: droidImage Enter を押します。開いたダイアログで、イメージ要素 ID へのすべての参照を更新することを確認します。

    Update 'Usages of imageView' dialog

UI レイアウトにテキストを追加する

次に、レイアウトにテキストを追加します。

  1. パレットペインで、TextView 要素を選択し、イメージのキャンバスにドラッグします。

    ウィジェットはいくつかのデフォルトテキスト TextView を表示します。これを変更して文字列にリンクするには、新しいテキストリソースを作成する必要があります。

  2. 左側のコンポーネントツリーtextView 要素を選択します。右側の属性ペインで、text 属性の横にあるリソースの選択アイコンthe Pick a Resource iconをクリックします。

    Pick a text resource
  3. 開いたダイアログで、左上隅にあるモジュールにリソースを追加するアイコンthe Add buttonをクリックし、文字列値を選択します。

  4. 新規文字列値ダイアログで、リソース名(welcome_text)とリソース値(Hello! I'm a droid.)を入力します。

    New String Value dialog
  5. OK をクリックして値を保存し、リソースの選択ダイアログで OK をクリックします。

  6. 次に、imageView で行ったのと同じ方法で textView 要素 ID を変更します。

    左側のコンポーネントツリーtextView を選択し、属性ペインで ID を新しい値 clickCounter に設定します。

テキストにスタイルを追加する

次に、テキストにスタイルを追加して、テキストをより魅力的に見せましょう。

  1. テキストを少しパディングします。パディング属性を見つけ、すべての値を 10dp に設定します。

    Padding attribute values
  2. フォントの色を変更します。textColor 属性のを見つけて、その横にthe Pick a Resource iconアイコンリソースの選択をクリックしてください。

    開いたダイアログで、左上隅にあるモジュールにリソースを追加するアイコンthe Add buttonをクリックし、色の値を選択します。

    リソース名(text_color)と値(#9C27B0)を入力します。

    Text color resource
  3. フォントサイズを変更します。TextSize プロパティを見つけて、その横にあるリソースの選択アイコンthe Pick a Resource iconをクリックします。

    開いたダイアログで、左上隅にあるモジュールにリソースを追加するアイコンthe Add buttonをクリックし、寸法値を選択します。

    リソース名(text_size)と値(24sp)を入力します。

    Text size value

その結果、ユーザーインターフェースは次のようになります。

Android UI preview

アプリケーション UI が横向きでどのように表示されるかを確認するには、デザイナーツールバーのプレビューの向きアイコンArtwork studio icons layout editor toolbar rotate buttonをクリックし、を選択します。

Lanscape orientation

さまざまなデバイスでレイアウトがどのように見えるかをプレビューするには、デバイスリストから別のデバイスを選択します。

Android UI layout preview

アプリケーションをインタラクティブにする

この時点ではサンプルアプリケーションは完全に機能していますが、まだどのような形式の対話もサポートしていません。タップイベントをサポートするように変更しましょう。

  1. Android プロジェクトビューで、app\java\com.example.hellodroid にある MainActivity ファイルを見つけ、ダブルクリックして開きます。

  2. MainActivity はあまり意味のあるクラス名ではないため、名前を変更しましょう。

    Android プロジェクトビューでこのファイルを右クリックし、コンテキストメニューからリファクタリング | 名前の変更を選択するか、Shift+F6 を押します。開いたダイアログで、クラス名 HelloDroidActivity を変更し、リファクタリングをクリックします。

    Rename dialog

    このクラスへの参照はすべて自動的に更新され、アプリケーションのソースコードは次のようになります。

    Android app source code
  3. HelloDroid.java のコードを次のように置き換えます。

    package com.example.hellodroid; import android.os.Bundle; import android.view.View; import android.widget.ImageView; import android.widget.TextView; import androidx.appcompat.app.AppCompatActivity; public class HelloDroidActivity extends AppCompatActivity { private TextView message; private int counter = 0; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); message = findViewById(R.id.clickCounter); ImageView droid = findViewById(R.id.droidImage); //Define and attach click listener droid.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { tapDroid(); } }); } private void tapDroid() { counter++; String countAsText; /* * In real applications you should not write switch like the one below. * Use resource of type "Quantity strings (plurals)" instead. * See https://developer.android.com/guide/topics/resources/string-resource#Plurals */ switch (counter) { case 1: countAsText = "once"; break; case 2: countAsText = "twice"; break; default: countAsText = String.format("%d times", counter); } message.setText(String.format("You touched the droid %s", countAsText)); } }

    ソースコードで使用した識別子は、レイアウト定義ファイルで設定した識別子に対応していることに注意してください。そうでない場合、コードは機能しません。

アプリケーションをビルドして実行する

次に、アプリケーションをビルドして、仮想デバイスで実行します。

Android 仮想デバイスを構成する

まず、アプリケーションを実行できるようにするには、仮想デバイスを構成する必要があります。

  1. メイン IntelliJ IDEA ツールバーで、デバイスリストをクリックし、AVD マネージャーを選択します。

    launch AVD Manager
  2. ウィザードの最初のステップで、仮想デバイスの作成をクリックします。

    Android AVD manager step 1
  3. 次のステップでは、仮想デバイスがエミュレートするハードウェアを選択する必要があります。

    左側で Phone を選択し、ターゲットデバイスとして Pixel 2 を選択します。

    Android AVD manager step 2
  4. 仮想デバイスで模倣するシステムイメージを選択します。つまり、OS バージョン、Android API レベル、アプリケーションバイナリインターフェース(ABI)、およびターゲット SDK バージョンです。

    Android AVD manager step 3
  5. 仮想デバイスで模倣するシステムイメージの横にあるダウンロードリンクをクリックします。このチュートリアルでは、R システムイメージをダウンロードすることを選択しました。

    開いたご使用条件ダイアログで、使用許諾契約を読んで同意し、次へをクリックして、ダウンロードが完了するまで待ちます。システムイメージがダウンロードされたら、それを選択し、ウィザードのシステムイメージステップで次へをクリックします。

  6. 最後のステップで、仮想デバイス名を変更し、画面の起動サイズと向きを選択できます。縦向きのレイアウトを選択し、完了をクリックします。

    Android AVD manager step 4
  7. 新しく構成されたデバイスが Android 仮想デバイスマネージャーに表示されます。

アプリケーションの実行

  1. メインの IntelliJ IDEA ツールバーで、自動的に作成された実行構成と構成したばかりの仮想デバイスが選択されていることを確認し、the Run buttonをクリックします。

    Run the Android application

    Android エミュレータは、ビルドが正常に完了した後に起動し、アプリケーションが起動します。

    The application started on an Android emulator
  2. ドロイドのイメージをクリックして、アプリケーションがタップイベントを処理し、カウントして、対応するメッセージを返す方法を確認します。

    The application counts tap events