이 튜토리얼에서는 안드로이드에서 강력한 이미지 로딩 라이브러리인 Picasso를 사용하는 방법을 단계별로 알아봅니다. Drawable 리소스 로드, URL 기반 이미지 로딩, 플레이스홀더 및 오류 이미지 설정, 콜백 처리, 크기 조절, 회전, 스케일링, Target 활용까지 Picasso의 핵심 기능을 모두 다룹니다.
1단계: 새 프로젝트 생성
Android Studio를 실행하고 File → New Project 메뉴로 이동한 후, 필요한 모든 세부 정보를 입력하여 새 프로젝트를 생성합니다.
2단계: Picasso 의존성 추가
Picasso를 사용하려면 먼저 앱 수준 build.gradle 파일에 아래 의존성을 추가하고 프로젝트를 동기화합니다.
dependencies {
implementation 'com.squareup.picasso:picasso:2.71828'
}3단계: 레이아웃 파일 작성
res/layout/activity_main.xml 파일에 다음 코드를 추가합니다. 화면 중앙에는 ImageView가 배치되고, 그 아래로 각 기능을 테스트할 수 있는 버튼들이 정렬됩니다.
<?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:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="16dp"
tools:context=".MainActivity">
<Button
android:id="@+id/btnDrawable"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentStart="true"
android:layout_centerVertical="true"
android:text="Drawable" />
<ImageView
android:id="@+id/imageView"
android:layout_width="200dp"
android:layout_height="200dp"
android:layout_centerHorizontal="true"
android:src="@mipmap/ic_launcher" />
<Button
android:id="@+id/btnPlaceholder"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/btnUrl"
android:layout_alignBottom="@+id/btnUrl"
android:layout_centerHorizontal="true"
android:text="Placeholder" />
<Button
android:id="@+id/btnUrl"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/btnDrawable"
android:layout_alignBottom="@+id/btnDrawable"
android:layout_alignParentEnd="true"
android:text="URL" />
<Button
android:id="@+id/btnError"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@+id/btnDrawable"
android:layout_alignParentStart="true"
android:layout_marginTop="12dp"
android:text="Error" />
<Button
android:id="@+id/btnCallBack"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/btnError"
android:layout_alignStart="@+id/btnPlaceholder"
android:layout_alignBottom="@+id/btnError"
android:text="Callback" />
<Button
android:id="@+id/btnResize"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/btnCallBack"
android:layout_alignBottom="@+id/btnCallBack"
android:layout_alignParentEnd="true"
android:text="Resize" />
<Button
android:id="@+id/btnRotate"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@+id/btnError"
android:layout_alignParentStart="true"
android:layout_marginTop="12dp"
android:text="Rotate" />
<Button
android:id="@+id/btnScale"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignStart="@+id/btnCallBack"
android:layout_alignBottom="@+id/btnTarget"
android:text="Scale" />
<Button
android:id="@+id/btnTarget"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/btnRotate"
android:layout_alignBottom="@+id/btnRotate"
android:layout_alignParentEnd="true"
android:text="Targets" />
</RelativeLayout>4단계: MainActivity 코드 작성
src/MainActivity.java 파일에 다음 코드를 추가합니다. 각 버튼 클릭 시 Picasso의 서로 다른 기능을 확인할 수 있습니다.
package app.com.sample;
import androidx.appcompat.app.AppCompatActivity;
import android.graphics.Bitmap;
import android.graphics.drawable.Drawable;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.Toast;
import com.squareup.picasso.Callback;
import com.squareup.picasso.Picasso;
import com.squareup.picasso.Target;
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
ImageView imageView;
int i = 0;
Button btnDrawableImage, btnUrlImage, btnErrorImage, btnPlaceholderImage,
btnCallback, btnResizeImage, btnRotateImage, btnScaleImage, btnTarget;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initView();
}
private void initView() {
imageView = findViewById(R.id.imageView);
btnDrawableImage = findViewById(R.id.btnDrawable);
btnUrlImage = findViewById(R.id.btnUrl);
btnPlaceholderImage = findViewById(R.id.btnPlaceholder);
btnErrorImage = findViewById(R.id.btnError);
btnCallback = findViewById(R.id.btnCallBack);
btnResizeImage = findViewById(R.id.btnResize);
btnRotateImage = findViewById(R.id.btnRotate);
btnScaleImage = findViewById(R.id.btnScale);
btnTarget = findViewById(R.id.btnTarget);
btnDrawableImage.setOnClickListener(this);
btnPlaceholderImage.setOnClickListener(this);
btnUrlImage.setOnClickListener(this);
btnCallback.setOnClickListener(this);
btnResizeImage.setOnClickListener(this);
btnErrorImage.setOnClickListener(this);
btnRotateImage.setOnClickListener(this);
btnScaleImage.setOnClickListener(this);
btnTarget.setOnClickListener(this);
}
@Override
public void onClick(View view) {
switch (view.getId()) {
// Drawable 리소스 로드
case R.id.btnDrawable:
Picasso.with(this).load(R.drawable.image).into(imageView);
break;
// 로딩 중 플레이스홀더 표시
case R.id.btnPlaceholder:
Picasso.with(this).load("www.journaldev.com")
.placeholder(R.drawable.placeholder)
.into(imageView);
break;
// URL에서 이미지 로드
case R.id.btnUrl:
Picasso.with(this)
.load("https://cdn.journaldev.com/wp-content/uploads/2017/01/android-constraintlayout-sdk-tool-install.png")
.placeholder(R.drawable.placeholder)
.into(imageView);
break;
// 로드 실패 시 오류 이미지 표시
case R.id.btnError:
Picasso.with(this).load("www.journaldev.com")
.placeholder(R.drawable.placeholder)
.error(R.drawable.error)
.into(imageView);
break;
// 성공/실패 콜백 처리
case R.id.btnCallBack:
Picasso.with(this).load("www.journaldev.com")
.error(R.mipmap.ic_launcher)
.into(imageView, new Callback() {
@Override
public void onSuccess() {
Log.d("TAG", "onSuccess");
}
@Override
public void onError() {
Toast.makeText(getApplicationContext(),
"An error occurred", Toast.LENGTH_SHORT).show();
}
});
break;
// 이미지 크기 조절
case R.id.btnResize:
Picasso.with(this).load(R.drawable.image)
.resize(200, 200)
.into(imageView);
break;
// 이미지 회전
case R.id.btnRotate:
Picasso.with(this).load(R.drawable.image)
.rotate(90f)
.into(imageView);
break;
// Fit / CenterCrop / CenterInside 스케일링 순환 테스트
case R.id.btnScale:
if (i == 3)
i = 0;
else {
if (i == 0) {
Picasso.with(this).load(R.drawable.image)
.fit().into(imageView);
Toast.makeText(getApplicationContext(), "Fit",
Toast.LENGTH_SHORT).show();
} else if (i == 1) {
Picasso.with(this).load(R.drawable.image)
.resize(200, 200).centerCrop().into(imageView);
Toast.makeText(getApplicationContext(), "Center Crop",
Toast.LENGTH_SHORT).show();
} else if (i == 2) {
Picasso.with(this).load(R.drawable.image)
.resize(200, 200).centerInside().into(imageView);
Toast.makeText(getApplicationContext(), "Center Inside",
Toast.LENGTH_SHORT).show();
}
i++;
}
break;
// Target을 사용한 직접 비트맵 제어
case R.id.btnTarget:
Picasso.with(this)
.load("https://cdn.journaldev.com/wp-content/uploads/2017/01/android-constraintlayout-sdk-tool-install.png")
.placeholder(R.drawable.placeholder)
.error(R.drawable.error)
.into(target);
break;
}
}
private Target target = new Target() {
@Override
public void onBitmapLoaded(Bitmap bitmap, Picasso.LoadedFrom from) {
imageView.setImageBitmap(bitmap);
}
@Override
public void onBitmapFailed(Drawable errorDrawable) {
imageView.setImageDrawable(errorDrawable);
}
@Override
public void onPrepareLoad(Drawable placeHolderDrawable) {
imageView.setImageDrawable(placeHolderDrawable);
}
};
}5단계: AndroidManifest.xml 설정
androidManifest.xml 파일에 다음 코드를 추가합니다.
참고: 인터넷에서 이미지를 불러오려면 매니페스트에 반드시 <uses-permission android:name="android.permission.INTERNET"/> 권한이 선언되어 있어야 합니다. 권한이 없으면 URL 기반 이미지 로딩이 실패합니다.
<?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.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.INTERNET"/>
<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(실행) 아이콘을 클릭합니다. 실행 옵션 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.
각 버튼을 눌러 Drawable 로드, 플레이스홀더, 오류 처리, 콜백, 리사이즈, 회전, 스케일링, Target 기능이 정상적으로 동작하는지 확인해 보세요. 이 예제를 통해 Picasso의 필수 API를 모두 익힐 수 있습니다.