안드로이드 앱을 개발하다 보면 파일 다운로드, 데이터 로딩 등 진행 상황을 시각적으로 보여줘야 할 때가 많습니다. 이때 기본 제공되는 가로 막대형 ProgressBar 대신 원형(Ring) ProgressBar를 사용하면 훨씬 세련된 UI를 구현할 수 있습니다.
이 글에서는 XML Drawable만으로 커스텀 원형 ProgressBar를 만드는 방법을 단계별로 알아보겠습니다.
Step 1 – 새 프로젝트 생성
Android Studio를 실행하고 File → New Project 메뉴로 이동한 뒤, 필요한 모든 정보를 입력하여 새 프로젝트를 생성합니다.
Step 2 – 원형 진행 바 Drawable 작성
res/drawable/circular_progress_bar.xml 파일을 새로 만들고 아래 코드를 추가합니다. 이 Drawable은 실제로 회전하며 진행 상황을 표시하는 부분입니다.
<?xml version="1.0" encoding="utf-8"?>
<rotate xmlns:android="https://schemas.android.com/apk/res/android"
android:fromDegrees="270"
android:toDegrees="270">
<shape
android:innerRadiusRatio="2.5"
android:shape="ring"
android:thickness="1dp"
android:useLevel="true"> <!-- lollipop(API 21) 이슈를 해결하는 라인 -->
<gradient
android:angle="0"
android:endColor="#007DD6"
android:startColor="#007DD6"
android:type="sweep"
android:useLevel="false" />
</shape>
</rotate>핵심 포인트:
android:useLevel="true"속성은 API 21(롤리팝) 이상에서 발생하는 표시 오류를 해결해 줍니다.innerRadiusRatio와thickness값을 조절하면 링의 두께와 크기를 자유롭게 변경할 수 있습니다.startColor와endColor를 다르게 설정하면 그라데이션 효과도 적용할 수 있습니다.
Step 3 – 배경용 원형 Shape 작성
진행 바 아래에 깔릴 연한 회색 배경 링을 만듭니다. res/drawable/circular_shape.xml 파일을 생성하고 다음 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="https://schemas.android.com/apk/res/android"
android:innerRadiusRatio="2.5"
android:shape="ring"
android:thickness="1dp"
android:useLevel="false">
<solid android:color="#CCC" />
</shape>배경 링은 useLevel="false"로 설정하여 진행률과 무관하게 항상 전체 원이 표시되도록 합니다.
Step 4 – 레이아웃에 ProgressBar 배치
res/layout/activity_main.xml에 아래 코드를 추가합니다. 기존 ProgressBar 스타일(progressBarStyleHorizontal)을 활용하면서 배경과 진행 Drawable만 교체하는 방식입니다.
<?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:layout_margin="16dp"
tools:context=".MainActivity">
<ProgressBar
android:id="@+id/progressBar"
style="?android:attr/progressBarStyleHorizontal"
android:layout_width="200dp"
android:layout_height="200dp"
android:layout_centerInParent="true"
android:background="@drawable/circular_shape"
android:indeterminate="false"
android:max="100"
android:progress="65"
android:progressDrawable="@drawable/circular_progress_bar" />
</RelativeLayout>여기서 android:max="100"은 최대값, android:progress="65"는 현재 진행률(65%)을 의미합니다. 코드에서 동적으로 값을 변경하려면 setProgress() 메서드를 사용하면 됩니다.
Step 5 – MainActivity 작성
src/MainActivity.java 파일에 다음 코드를 추가합니다.
package app.tutorialspoint.com.sample;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}참고: 예전에는 android.support.v7.app.AppCompatActivity를 사용했지만, 현재 안드로이드 프로젝트는 AndroidX(androidx.appcompat.app.AppCompatActivity) 라이브러리를 표준으로 사용하므로 위 코드처럼 임포트 경로를 androidx로 지정하는 것이 좋습니다.
Step 6 – AndroidManifest.xml 확인
androidManifest.xml에 아래와 같이 액티비티가 정상적으로 등록되어 있는지 확인합니다.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="app.tutorialspoint.com.sample">
<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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 상단 툴바의 Run 아이콘을 클릭하세요. 실행할 디바이스 목록에서 본인의 모바일 기기를 선택하면, 화면에 아래와 같이 65%까지 채워진 원형 ProgressBar가 나타납니다.
마무리
이처럼 간단한 XML Drawable 몇 개만으로도 기본 ProgressBar를 멋진 원형 인디케이터로 변신시킬 수 있습니다. 색상, 두께, 시작 각도 등을 조절해 자신만의 스타일로 커스터마이징해 보세요. 다운로드 진행률, 설문 결과, 통계 대시보드 등 다양한 곳에서 활용하기 좋습니다.