앱 위젯은 구성 가능합니다. 예를 들어 시계 위젯을 사용하면 사용자가 표시할 시간대를 구성합니다.
사용자가 위젯 설정을 구성할 수 있도록 하려면 위젯을 만드세요.
구성 Activity
이 활동은
위젯이 생성될 때 앱 위젯 호스트에 의해 자동으로 실행됩니다.
또는 나중에 실행하는 구성 옵션에 따라
지정합니다
구성 활동 선언
Android 매니페스트에서 구성 활동을 일반 활동으로 선언
파일에서 참조됩니다. 앱 위젯 호스트는
ACTION_APPWIDGET_CONFIGURE
드림
활동이 이 인텐트를 수락해야 합니다. 예를 들면 다음과 같습니다.
<activity android:name=".ExampleAppWidgetConfigurationActivity">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_CONFIGURE"/>
</intent-filter>
</activity>
AppWidgetProviderInfo.xml
파일에서 다음과 같이 활동을 선언합니다.
android:configure
속성 다음에 대해 자세히 알아보기
이 파일을 선언합니다. 이 예시에서는
방법은 다음과 같습니다.
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
...
android:configure="com.example.android.ExampleAppWidgetConfigurationActivity"
... >
</appwidget-provider>
런처가 완전히 자격을 갖춘 네임스페이스로 선언되는 이유는 패키지 범위 밖에서 이를 참조할 수 있습니다.
이것으로 구성 활동을 시작하는 데 필요한 모든 것입니다. 다음으로 실제 활동을 구현할 수 있습니다.
구성 활동 구현
활동을 구현할 때 기억해야 할 두 가지 중요한 사항이 있습니다.
- 앱 위젯 호스트가 구성 활동을 호출하고
활동은 항상 결과를 반환해야 합니다. 결과에 앱 위젯이 포함되어야 합니다.
활동을 시작한 인텐트에서 전달한 ID(인텐트에 저장됨)
추가 기능을
EXTRA_APPWIDGET_ID
- 시스템은
ACTION_APPWIDGET_UPDATE
드림 구성 활동이 시작될 때 브로드캐스트합니다. 즉, 위젯이 생성될 때onUpdate()
메서드를 호출합니다. 구성 활동의 책임은AppWidgetManager
에서 발생해야 합니다. 하지만onUpdate()
는 후속 업데이트를 위해 호출되며 확인할 수 있습니다
를 반환하는 방법의 예는 다음 섹션의 코드 스니펫을 참조하세요. 결과를 가져와 위젯을 업데이트합니다.
구성 활동에서 위젯 업데이트
위젯이 구성 활동을 사용하는 경우
구성 완료 시 위젯을 업데이트하기 위한 활동 할 수 있습니다
직접 업데이트를 요청하여
AppWidgetManager
다음은 위젯을 올바르게 업데이트하고 구성 활동:
활동을 실행한 인텐트에서 앱 위젯 ID를 가져옵니다.
Kotlin
val appWidgetId = intent?.extras?.getInt( AppWidgetManager.EXTRA_APPWIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID ) ?: AppWidgetManager.INVALID_APPWIDGET_ID
자바
Intent intent = getIntent(); Bundle extras = intent.getExtras(); int appWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID; if (extras != null) { appWidgetId = extras.getInt( AppWidgetManager.EXTRA_APPWIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); }
활동 결과를
RESULT_CANCELED
로 설정합니다.이런 식으로 사용자가 끝에 도달하기 전에 활동을 물러나면 시스템이 앱 위젯 호스트에 구성이 취소되었음을 알리고 호스트가 위젯을 추가하지 않는 경우:
Kotlin
val resultValue = Intent().putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId) setResult(Activity.RESULT_CANCELED, resultValue)
자바
int resultValue = new Intent().putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId); setResult(Activity.RESULT_CANCELED, resultValue);
사용자의 환경설정에 따라 위젯을 구성합니다.
구성이 완료되면
getInstance(Context)
를 호출하여AppWidgetManager
합니다.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context)
자바
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
다음으로 위젯을 업데이트합니다. 다음을 호출하여
RemoteViews
레이아웃updateAppWidget(int,RemoteViews)
:Kotlin
val views = RemoteViews(context.packageName, R.layout.example_appwidget) appWidgetManager.updateAppWidget(appWidgetId, views)
자바
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.example_appwidget); appWidgetManager.updateAppWidget(appWidgetId, views);
반환 인텐트를 만들고 활동 결과로 설정합니다. 마무리:
Kotlin
val resultValue = Intent().putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId) setResult(Activity.RESULT_OK, resultValue) finish()
자바
Intent resultValue = new Intent().putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId); setResult(RESULT_OK, resultValue); finish();
자세한 내용은
ListWidgetConfigureActivity.kt
드림
를 참조하세요.
위젯 구성 옵션
기본적으로 앱 위젯 호스트는 구성 활동을 한 번만 시작합니다. 를 표시할 수 있습니다. 하지만 사용자가 기존 위젯을 재구성하거나 기본 위젯 구성을 제공하여 초기 위젯 구성을 건너뜁니다.
사용자가 배치된 위젯을 재구성할 수 있도록 함
사용자가 기존 위젯을 재구성할 수 있도록 하려면
reconfigurable
드림
플래그
widgetFeatures
속성 appwidget-provider
. 자세한 내용은
AppWidgetProviderInfo.xml
파일을 참고하세요.
확인할 수 있습니다 예를 들면 다음과 같습니다.
<appwidget-provider
android:configure="com.myapp.ExampleAppWidgetConfigurationActivity"
android:widgetFeatures="reconfigurable">
</appwidget-provider>
사용자는 위젯을 다시 설정하려면 위젯을 누른 채 다음 라벨이 지정된 재구성 버튼을 그림 1의 1
![버튼이 오른쪽 하단에 표시됨](https://android-dot-devsite-v2-prod.appspot.com/static/images/appwidgets/widget-reconfigure-button.png?hl=ko)
위젯의 기본 구성 사용
사용자가
초기 구성 단계 이렇게 하려면
configuration_optional
드림
widgetFeatures
필드에 reconfigurable
플래그를 포함합니다. 이를 통해 사용자가 위젯을 추가한 후 구성 활동 실행을 우회할 수 있습니다. 언급했듯이
이전에도 사용자가 계속 위젯을 재구성할 수 있습니다.
있습니다. 예를 들어, 시계 위젯은 초기 구성을 우회하고
기본적으로 기기 시간대가 표시됩니다.
다음은 구성 활동을 다음과 같습니다.
<appwidget-provider
android:configure="com.myapp.ExampleAppWidgetConfigurationActivity"
android:widgetFeatures="reconfigurable|configuration_optional">
</appwidget-provider>