안드로이드에서 URL로 이미지 다운로드하는 방법 (단계별 코드 예제)

이 글에서는 안드로이드 앱에서 URL을 통해 이미지를 다운로드해 화면에 표시하는 방법을 단계별 예제와 함께 소개합니다. 버튼을 누르면 지정된 URL에서 이미지를 내려받아 ImageView에 출력하는 간단한 데모 앱을 직접 만들어 보겠습니다.

1단계 — 새 프로젝트 만들기

Android Studio에서 File → New Project 메뉴로 이동한 뒤, 프로젝트 생성에 필요한 정보를 모두 입력해 새 프로젝트를 만듭니다.

2단계 — 레이아웃 작성 (res/layout/activity_main.xml)

다음 코드를 res/layout/activity_main.xml 파일에 추가합니다. 화면 중앙에는 다운로드한 이미지를 보여줄 ImageView, 그 아래에는 다운로드를 시작하는 Button을 배치했습니다.

<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    <ImageView
        android:id="@+id/image"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_centerVertical="true">
    </ImageView>
    <Button
        android:id="@+id/button"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_below="@+id/image"
        android:layout_centerHorizontal="true"
        android:layout_centerVertical="true"
        android:text="@string/button" />
</RelativeLayout>

3단계 — MainActivity.java 작성

src/MainActivity.java에 아래 코드를 추가합니다. 핵심은 AsyncTask를 상속한 DownloadImage 클래스입니다. 네트워크 작업은 반드시 백그라운드 스레드에서 수행해야 하므로, doInBackground()에서 이미지를 다운로드하고 디코딩한 뒤 onPostExecute()에서 UI 스레드의 ImageView에 결과를 설정하는 구조로 동작합니다.

import android.app.ProgressDialog;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.AsyncTask;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import java.io.InputStream;

public class MainActivity extends AppCompatActivity {
    String url = "https://images.pexels.com/photos/1226302/pexels-photo1226302.jpeg?auto=compress&cs=tinysrgb&dpr=1&w=500";
    ImageView image;
    Button button;
    ProgressDialog mProgressDialog;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        image = (ImageView) findViewById(R.id.image);
        button = findViewById(R.id.button);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                new DownloadImage().execute(url);
            }
        });
    }

    private class DownloadImage extends AsyncTask {
        @Override
        protected void onPreExecute() {
            super.onPreExecute();
            mProgressDialog = new ProgressDialog(MainActivity.this);
            mProgressDialog.setTitle("Download Image Tutorial");
            mProgressDialog.setMessage("Loading...");
            mProgressDialog.setIndeterminate(false);
            mProgressDialog.show();
        }

        @Override
        protected Bitmap doInBackground(String... URL) {
            String imageURL = URL[0];
            Bitmap bitmap = null;
            try {
                // URL에서 이미지 다운로드
                InputStream input = new java.net.URL(imageURL).openStream();
                // 비트맵으로 디코딩
                bitmap = BitmapFactory.decodeStream(input);
            } catch (Exception e) {
                e.printStackTrace();
            }
            return bitmap;
        }

        @Override
        protected void onPostExecute(Bitmap result) {
            // 다운로드한 비트맵을 ImageView에 설정
            image.setImageBitmap(result);
            // 진행 대화상자 닫기
            mProgressDialog.dismiss();
        }
    }
}

4단계 — 문자열 리소스 추가 (res/values/strings.xml)

resources 폴더의 strings.xml 파일을 열고 다음 코드를 추가합니다.

<resources>
    <string name="app_name">Sample</string>
    <string name="menu_settings">Settings</string>
    <string name="button">Download Image</string>
</resources>

5단계 — 인터넷 권한 선언 (AndroidManifest.xml)

앱이 네트워크에 접근해야 하므로 androidManifest.xml에 INTERNET 권한을 반드시 선언해야 합니다. 이 단계를 누락하면 이미지 다운로드가 정상적으로 동작하지 않습니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <uses-permission android:name="android.permission.INTERNET" ></uses-permission>
    <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 아이콘을 클릭하고, 기기 목록에서 자신의 모바일 기기를 선택하세요. 앱이 실행되면 기본 화면이 표시됩니다.

참고: 최신 개발 환경이라면?

위 예제에서 사용한 AsyncTask는 API 30(안드로이드 11)부터 공식적으로 지원 중단(deprecated)되었습니다. 최신 프로젝트에서는 Kotlin 코루틴(Coroutines)이나 WorkManager를 사용하는 것이 권장되며, 이미지 로딩 전용 라이브러리인 Glide 또는 Coil을 활용하면 한두 줄의 코드만으로 URL 이미지를 불러오고 캐싱까지 자동으로 처리할 수 있습니다.