안드로이드에서 원형 커스텀 진행률 표시줄(Circular ProgressBar) 만드는 방법

이 튜토리얼에서는 안드로이드 앱에서 원형 커스텀 진행률 표시줄(Circular Custom Progress Bar)을 구현하는 방법을 단계별로 알아봅니다. XML 드로어블(Drawable)과 자바 코드만으로 별도의 라이브러리 없이 부드럽게 애니메이션되는 원형 프로그레스바를 만들 수 있습니다.

1단계: 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 새 프로젝트를 생성하는 데 필요한 모든 정보를 입력하여 프로젝트를 만듭니다.

2단계: 레이아웃 파일 작성 (activity_main.xml)

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 중앙에 배치된 ProgressBar와 그 위에 겹쳐지는 TextView로 구성됩니다.

<?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"
    android:padding="8dp"
    tools:context=".MainActivity">
<ProgressBar
    android:id="@+id/circularProgressbar"
    style="?android:attr/progressBarStyleHorizontal"
    android:layout_width="250dp"
    android:layout_height="250dp"
    android:layout_centerInParent="true"
    android:indeterminate="false"
    android:max="100"
    android:progress="50"
    android:secondaryProgress="100" />
<TextView
    android:id="@+id/textView"
    android:layout_width="250dp"
    android:layout_height="250dp"
    android:gravity="center"
    android:text="25%"
    android:layout_centerInParent="true"
    android:textColor="@color/colorPrimaryDark"
    android:textSize="24sp" />
</RelativeLayout>

3단계: 드로어블 리소스 파일 작성 (circularprogressbar.xml)

drawable 폴더에 circularprogressbar.xml이라는 이름의 드로어블 리소스 파일을 생성하고 아래 코드를 추가합니다. 이 파일은 배경 링(회색)과 진행 상태를 나타내는 링(녹색)을 layer-list로 겹쳐서 정의합니다.

<layer-list xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">
    <item android:id="@android:id/secondaryProgress">
        <shape
            android:innerRadiusRatio="6"
            android:shape="ring"
            android:thicknessRatio="20.0"
            android:useLevel="true">
            <gradient
                android:centerColor="#999999"
                android:endColor="#999999"
                android:startColor="#999999"
                android:type="sweep" />
        </shape>
    </item>
    <item android:id="@android:id/progress">
        <rotate
            android:fromDegrees="270"
            android:pivotX="50%"
            android:pivotY="50%"
            android:toDegrees="270">
            <shape
                android:innerRadiusRatio="6"
                android:shape="ring"
                android:thicknessRatio="20.0"
                android:useLevel="true">
                <gradient
                    android:centerColor="#00FF00"
                    android:endColor="#00FF00"
                    android:startColor="#00FF00"
                    android:type="sweep" />
                    <rotate
                        android:fromDegrees="0"
                        android:pivotX="50%"
                        android:pivotY="50%"
                        android:toDegrees="360" />
            </shape>
        </rotate>
    </item>
    <item android:id="@android:id/secondaryProgress">
        <shape
            android:innerRadiusRatio="6"
            android:shape="ring"
            android:thicknessRatio="20.0"
            android:useLevel="true">
            <gradient
                android:centerColor="#999999"
                android:endColor="#999999"
                android:startColor="#999999"
                android:type="sweep" />
        </shape>
    </item>
</layer-list>

4단계: MainActivity.java 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다. 백그라운드 스레드에서 진행률을 증가시키고, Handler를 통해 UI 스레드에서 프로그레스바와 텍스트를 갱신하는 방식입니다.

import androidx.appcompat.app.AppCompatActivity;
import android.content.res.Resources;
import android.graphics.drawable.Drawable;
import android.os.Bundle;
import android.os.Handler;
import android.widget.ProgressBar;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {
    int status = 0;
    private Handler handler = new Handler();
    TextView textView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Resources resources = getResources();
        Drawable drawable = resources.getDrawable(R.drawable.circularprogressbar);
        final ProgressBar progressBar = findViewById(R.id.circularProgressbar);
        progressBar.setProgress(0);
        progressBar.setSecondaryProgress(100);
        progressBar.setMax(100);
        progressBar.setProgressDrawable(drawable);
        textView = findViewById(R.id.textView);
        new Thread(new Runnable() {
            @Override
            public void run() {
                while (status < 100) {
                    status += 1;
                    handler.post(new Runnable() {
                        @Override
                        public void run() {
                            progressBar.setProgress(status);
                            textView.setText(String.format("%d%%", status));
                        }
                    });
                    try {
                        Thread.sleep(16);
                    }
                    catch (InterruptedException e) {
                        e.printStackTrace();
                    }
                }
            }
        }).start();
    }
}

5단계: AndroidManifest.xml 확인

androidManifest.xml에는 특별한 권한 추가 없이 기본 설정 그대로 두면 됩니다.

앱 실행하기

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 스마트폰을 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바에서 Run 아이콘을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면, 연결된 기기 화면에서 아래와 같이 원형 프로그레스바가 0%부터 100%까지 부드럽게 채워지는 것을 확인할 수 있습니다.