Android 홈바로가기(Shortcut) 생성

홈바로가기 생성은 아래 코드 참고

 

사용법

 
String name = 바로가기의 이름 설정
int flag = 바로가기 실행 시 구분하기 위한 값 (필수가 아니므로 없어도 무방)
int resId = 바로가기 아이콘 설정
 
addShortcut(name, flag, resId);

 

관련 코드

    private static final String ACTION_INSTALL_SHORTCUT = "com.android.launcher.action.INSTALL_SHORTCUT";
    private static final String EXTRA_KEY_SHORTCUT = "extra_key_shortcut";
 
    /**
     * 바로가기 생성 (버전 체크)
     *
     * @param name 바로가기 이름
     * @param flag 바로가기 실행시 구분 값
     * @param resId 바로가기 아이콘
     */
    public void addShortcut(String name, int flag, @DrawableRes int resId) {
        Intent action= new Intent(context, StartActivity.class);
        action.putExtra(EXTRA_KEY_SHORTCUT, flag);    // 앱 내에서 바로가기 실행을 구분하기 위한 값
 
        // 디바이스의 현재버전 비교
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
            sendShortcut(name, resId, action);        // 오레오 아래인 경우
        } else {
            sendShortcutOreo(name, resId, action);     // 오레오인 경우
        }
    }
 
    /**
     * 바로가기 생성 (오레오를 제외한 버전)
     *
     * @param name 바로가기 이름
     * @param resId 바로가기 아이콘
     * @param action 바로가기 인텐트 설정
     */
    private void sendShortcut(String name, @DrawableRes int resId, Intent action) {
        Intent intent = new Intent(ACTION_INSTALL_SHORTCUT);
        intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);
        intent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
                Intent.ShortcutIconResource.fromContext(getContext(), resId));
        intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, action);
        getContext().sendBroadcast(intent);
    }
 
    /**
     * 바로가기 생성 (오레오 버전)
     *
     * @param name 바로가기 이름
     * @param resId 바로가기 아이콘
     * @param action 바로가기 인텐트 설정
     */
    @TargetApi(Build.VERSION_CODES.O)
    private void sendShortcutOreo(String name, @DrawableRes int resId, Intent action) {
        ShortcutManager shortcutManager = getContext().getSystemService(ShortcutManager.class);
        if (shortcutManager.isRequestPinShortcutSupported()) {
            ShortcutInfo pinShortcutInfo = new ShortcutInfo.Builder(getContext(), name) // 여러종류를 생성할 경우 구분하기 위한 값으로 꼭 name으로 안해도 됨
                    .setIntent(action)
                    .setShortLabel(name)
                    .setIcon(Icon.createWithResource(getContext(), resId)).build();
            Intent pinnedShortcutCallbackIntent = shortcutManager.createShortcutResultIntent(pinShortcutInfo);
            PendingIntent successCallback = PendingIntent.getBroadcast(getContext(), 0, pinnedShortcutCallbackIntent, 0);
 
            shortcutManager.requestPinShortcut(pinShortcutInfo, successCallback.getIntentSender());
        }
    }