KotlinでAndroidアプリにGridViewレイアウトを実装する方法【初心者向け解説】

この記事では、Kotlinを使用してAndroidアプリにGridView（グリッドビュー）レイアウトを作成する方法を、ステップごとに詳しく解説します。GridViewを使うと、画像やテキストを格子状に並べて表示できるため、ギャラリーアプリやメニュー画面などでよく活用されています。

ステップ1：新規プロジェクトの作成

まず、Android Studioを開き、「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトのセットアップを完了させてください。

ステップ2：activity_main.xmlにコードを追加

次に、res/layout/activity_main.xmlに以下のコードを追加します。ここでは、2列のGridViewを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
<GridView
    android:id="@+id/gridView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:numColumns="2" />
</RelativeLayout>

ステップ3：MainActivity.ktにコードを追加

続いて、src/MainActivity.ktに以下のコードを記述します。この例では、サッカー選手の名前と画像の配列を用意し、GridViewにアダプターを設定しています。また、アイテムがクリックされたときにToastで選択された選手名を表示する処理も実装しています。

import android.os.Bundle
import android.widget.AdapterView.OnItemClickListener
import android.widget.GridView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    lateinit var gridView: GridView
    private var playerNames = arrayOf("Cristiano Ronaldo", "Joao Felix", "Bernado Silva", "Andre Silve", "Bruno Fernandez", "William Carvalho", "Nelson Semedo", "Pepe", "Rui Patricio")
    private var playerImages = intArrayOf(R.drawable.ronaldo, R.drawable.felix, R.drawable.bernado, R.drawable.andre, R.drawable.bruno, R.drawable.carvalho, R.drawable.semedo, R.drawable.pepe, R.drawable.patricio)
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        gridView = findViewById(R.id.gridView)
        val mainAdapter = MainAdapter(this@MainActivity, playerNames, playerImages)
        gridView.adapter = mainAdapter
        gridView.onItemClickListener = OnItemClickListener { _, _, position, _ ->
            Toast.makeText(applicationContext, "You Clicked " + playerNames[+position], Toast.LENGTH_SHORT).show()
        }
    }
}

ステップ4：カスタムアダプタークラス（MainAdapter.kt）の作成

次に、新しいKotlinクラスファイル「MyAdapter.kt」を作成し、以下のコードを追加します。このカスタムアダプターはBaseAdapterを継承しており、GridViewの各セルに画像とテキストを表示する役割を担います。

import android.content.Context
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.BaseAdapter
import android.widget.ImageView
import android.widget.TextView
internal class MainAdapter(
    private val context: Context,
    private val numbersInWords: Array<String>,
    private val numberImage: IntArray
) : BaseAdapter() {
    private var layoutInflater: LayoutInflater? = null
    private lateinit var imageView: ImageView
    private lateinit var textView: TextView
    override fun getCount(): Int {
        return numbersInWords.size
    }
    override fun getItem(position: Int): Any? {
        return null
    }
    override fun getItemId(position: Int): Long {
        return 0
    }
    override fun getView(
    position: Int,
    convertView: View?,
    parent: ViewGroup
    ): View? {
        var convertView = convertView
        if (layoutInflater == null) {
            layoutInflater = context.getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater
        }
        if (convertView == null) {
            convertView = layoutInflater!!.inflate(R.layout.rowitem, null)
        }
        imageView = convertView!!.findViewById(R.id.imageView)
        textView = convertView.findViewById(R.id.textView)
        imageView.setImageResource(numberImage[position])
        textView.text = numbersInWords[position]
        return convertView
    }
}

ステップ5：row_item.xmlレイアウトファイルの作成

次に、新しいLayout Resourceファイル「row_item.xml」を作成し、以下のコードを追加します。このレイアウトは、GridViewの各セルに表示されるImageViewとTextViewを縦方向に配置したものです。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:gravity="center"
    android:padding="8dp">
<ImageView
    android:id="@+id/imageView"
    android:layout_width="100dp"
    android:layout_height="100dp" />
<TextView
    textAlignment="center"
    android:gravity="center"
    android:id="@+id/textView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="16dp"
    android:text="Numbers"
    android:layout_marginBottom="10dp"
    android:textColor="@android:color/background_dark"
    android:textSize="24sp"
    android:textStyle="bold" />
</LinearLayout>

ステップ6：AndroidManifest.xmlのコード確認

最後に、androidManifest.xmlが以下のようになっていることを確認してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
               <action android:name="android.intent.action.MAIN" />
               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それでは、アプリケーションを実行してみましょう。ここでは、実際のAndroidスマートフォンがパソコンに接続されているものとします。Android Studioからアプリを実行するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーにある「Run」アイコンをクリックします。

デバイスの選択画面が表示されたら、接続しているモバイル端末を選択してください。その後、スマートフォンの画面を確認すると、GridViewに選手の画像と名前がグリッド状に表示されます。

各セルをタップすると、Toastメッセージでクリックした選手の名前が表示されることも確認できます。これで、Kotlinを使ったGridViewレイアウトの基本的な実装は完了です。ぜひ自分のプロジェクトでも応用してみてください。