위젯/바로가기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Android 8.0에 바로가기 및 위젯을 추가하는 데 사용되는 새로운 Flow API는 애플리케이션 개발자가 위젯 트레이에 의존하는 대신 앱 내부에서 바로가기와 위젯을 추가할 수 있게 해줍니다. 또한 보안을 이유로 바로가기 추가를 위한 기존 방식(브로드캐스트 전송)이 지원 중단됩니다.

런처는 앱 개발자가 바로가기나 위젯을 추가할 때 시스템을 신뢰할 수 있도록 이러한 새 구현을 지원해야 합니다.

예시 및 소스

문서는 다양한 시스템 클래스로 제공됩니다. 참조 문서는 다음과 같습니다.

  • ShortcutManager.java
    고정된 바로가기 섹션을 헤더에 게시합니다.
  • Intent.java
    ACTION_CREATE_SHORTCUT을 위한 Javadoc입니다.
  • AppWidgetManager.java
    requestPinAppWidget의 Javadoc입니다.

구현

기기 구현자는 런처에 활동과 인텐트 필터 작업을 추가해야 합니다.

  • android.content.pm.action.CONFIRM_PIN_SHORTCUT
  • android.content.pm.action.CONFIRM_PIN_APPWIDGET

자세한 내용은 API 문서를 참고하세요.

이 활동은 요청된 위젯/바로가기를 추가하고, 수락 시 상응하는 위젯/바로가기를 홈 화면에 추가하라는 확인 메시지를 사용자에게 표시해야 합니다.

위젯의 경우 accept() 호출에는 새로 추가된 위젯의 위젯 ID가 포함되어야 합니다.

시스템 UI 구현

파트너는 Launcher3 구현(packages/apps/Launcher3)을 참조하여 런처 앱을 업데이트해야 합니다.

Android 오픈소스 프로젝트(AOSP)에서 Launcher3 관련 변경사항을 찾습니다.

유효성 검사

기능의 유효성을 검사하려면 Chrome 또는 연락처 앱에서 바로가기를 추가하고 확인 메시지가 제대로 표시되는지 확인합니다. 수락 후에는 아이콘이 홈 화면에 추가되어야 하며 Chrome에 성공 토스트 메시지가 표시되어야 합니다.