Kotlinで作るAndroidカスタムプログレスバーの実装方法

Kotlinで作るAndroidカスタムプログレスバーの実装方法

このチュートリアルでは、Kotlinを使用してAndroidアプリにカスタムプログレスバー（進捗バー）を実装する方法を、ステップごとにわかりやすく解説します。円形のオリジナルデザインのプログレスバーを作成し、コードから進捗状況を自由に制御できるようになります。

ステップ1：新規プロジェクトを作成する

Android Studioを開き、メニューから「File」→「New Project」を選択します。必要な項目をすべて入力して、新しいプロジェクトを作成してください。

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

res/layout/activity_main.xml に以下のコードを記述します。画面中央に200dp四方の大きな円形プログレスバーを配置し、progressDrawable属性でカスタムドローアブル（@drawable/circle）を指定することで、独自の見た目を実現しています。

<?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">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="70dp"
        android:background="#008080"
        android:padding="5dp"
        android:text="TutorialsPoint"
        android:textColor="#fff"
        android:textSize="24sp"
        android:textStyle="bold" />
    <ProgressBar
        android:layout_centerInParent="true"
        android:layout_width="200dp"
        android:layout_height="200dp"
        style="?android:progressBarStyleLarge"
        android:progress="100"
        android:id="@+id/progressBar"
        android:progressDrawable="@drawable/circle"/>
</RelativeLayout>

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

src/MainActivity.kt に以下のコードを記述します。findViewByIdでプログレスバーを取得し、最大値（max）を100、現在の進捗値（progress）を20に設定しています。この数値を変更すれば、好きなタイミングで進捗を制御できます。

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.widget.ProgressBar
class MainActivity : AppCompatActivity() {
    lateinit var progressBar: ProgressBar
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        progressBar = findViewById(R.id.progressBar)
        progressBar.max = 100
        progressBar.progress = 20
    }
}

ステップ4：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」アイコン をクリックします。実行デバイスとして接続済みのモバイル端末を選択すると、端末の画面にアプリが起動し、カスタムプログレスバーが正しく表示されていることを確認できます。