개요
이 예제는 안드로이드 앱에서 프로그래밍 방식으로 홈 화면에 바로 가기(단축 아이콘)를 만드는 방법을 보여줍니다. 안드로이드 8.0(오레오)부터 도입된 ShortcutManagerCompat를 활용하면 사용자가 버튼 하나만 눌러도 원하는 화면의 단축 아이콘을 런처에 고정(Pin)할 수 있습니다.
1단계 − 새 프로젝트 생성
Android Studio에서 새 프로젝트를 생성합니다. 메뉴에서 File ⇒ New Project로 이동한 후, 새 프로젝트를 만드는 데 필요한 모든 정보를 입력합니다.
2단계 − 레이아웃 작성
res/layout/activity_main.xml 파일에 다음 코드를 추가합니다.
<?xml version = "1.0" encoding = "utf-8"?> <LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android" android:orientation = "vertical" android:layout_width = "match_parent" android:gravity = "center" android:layout_height = "match_parent"> <TextView android:id = "@+id/text" android:layout_width = "fill_parent" android:gravity = "center" android:textSize = "30sp" android:layout_height = "wrap_content" android:text = "Click here"/> </LinearLayout>
위 코드에서는 클릭 이벤트를 받을 텍스트 뷰 하나를 배치했습니다. 실제 앱에서는 버튼 위젯을 사용해도 동일하게 구현할 수 있습니다.
3단계 − MainActivity.java 작성
src/MainActivity.java 파일에 다음 코드를 추가합니다.
package com.example.myapplication;
import android.app.Activity;
import android.content.Intent;
import android.content.SharedPreferences;
import android.net.Uri;
import android.os.Bundle;
import android.support.v4.content.pm.ShortcutInfoCompat;
import android.support.v4.content.pm.ShortcutManagerCompat;
import android.support.v4.graphics.drawable.IconCompat;
import android.view.View;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends Activity {
private static final String PREF_KEY_SHORTCUT_ADDED = "Sairam";
TextView text;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
text = findViewById(R.id.text);
text.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (ShortcutManagerCompat.isRequestPinShortcutSupported(getApplicationContext())) {
ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(getApplicationContext(), "#1")
.setIntent(new Intent(getApplicationContext(), MainActivity.class).setAction(Intent.ACTION_MAIN)) // !!! 오레오에서는 intent의 action을 반드시 설정해야 합니다
.setShortLabel("Test")
.setIcon(IconCompat.createWithResource(getApplicationContext(), R.drawable.logo))
.build();
ShortcutManagerCompat.requestPinShortcut(getApplicationContext(), shortcutInfo, null);
} else {
Toast.makeText(MainActivity.this,"launcher does not support short cut icon",Toast.LENGTH_LONG).show();
}
}
});
}
}핵심 로직 설명
isRequestPinShortcutSupported(): 현재 런처가 핀 고정 바로 가기 기능을 지원하는지 확인합니다. 지원하지 않으면 토스트 메시지로 사용자에게 알립니다.ShortcutInfoCompat.Builder: 바로 가기의 고유 ID, 실행 인텐트, 표시 라벨, 아이콘을 정의합니다. 안드로이드 8.0(오레오) 이상에서는 인텐트에 반드시setAction(Intent.ACTION_MAIN)을 지정해야 합니다.requestPinShortcut(): 시스템 확인 대화상자를 띄워 사용자 승인 후 홈 화면에 단축 아이콘을 고정합니다.
4단계 − Manifest.xml 수정
Manifest.xml 파일에 다음 코드를 추가합니다.
<?xml version = "1.0" encoding = "utf-8"?> <manifest xmlns:android = "https://schemas.android.com/apk/res/android" package = "com.example.myapplication"> <uses-permission android:name = "android.permission.INTERNET" /> <uses-permission android:name = "com.android.launcher.permission.INSTALL_SHORTCUT" /> <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" android:configChanges = "keyboardHidden|orientation|screenSize"> <intent-filter> <action android:name = "android.intent.action.MAIN" /> <action android:name = "android.intent.action.CREATE_SHORTCUT" /> <category android:name = "android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
매니페스트에는 INSTALL_SHORTCUT 권한을 선언하고, 액티비티의 인텐트 필터에 CREATE_SHORTCUT 액션을 함께 등록해야 일부 런처에서 바로 가기 생성이 정상적으로 동작합니다.
실행 및 결과 확인
애플리케이션을 실행해 보겠습니다. 실제 안드로이드 모바일 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 앱을 실행하려면 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭합니다. 목록에서 자신의 모바일 기기를 선택하면, 기기에 앱의 기본 화면이 표시됩니다.
이제 홈 버튼을 눌러 홈 화면으로 이동하면, 다음과 같이 새로 생성된 바로 가기 아이콘이 추가된 것을 확인할 수 있습니다.