Glance의 오류 처리를 개선하기 위한 API 기능은 Android 15 이 페이지에서는 이러한 API와 관련된 몇 가지 권장사항을 제공합니다.
구성 불가능한 구성요소 주변에 try-catch 블록 사용
Compose는 컴포저블 주위에 try-catch 블록을 허용하지 않지만 래핑할 수 있음 앱의 다른 로직은 이러한 블록 안에 있어야 합니다 이렇게 하면 오류 뷰를 살펴보겠습니다.
provideContent {
var isError = false;
var data = null
try {
val repository = (context.applicationContext as MyApplication).myRepository
data = repository.loadData()
} catch (e: Exception) {
isError = true;
//handleError
}
if (isError) {
ErrorView()
} else {
Content(data)
}
}
기본 오류 레이아웃
포착되지 않은 예외나 Compose 오류가 있으면 Glance에 기본 오류 레이아웃:
<ph type="x-smartling-placeholder">![오류 유형을 보여주는 오류 메시지 및 추천 위치
그것을 찾기 위해](https://developer.android.google.cn/static/partners/glance/images/default_error_layout.png?authuser=19&hl=ko)
!['콘텐츠를 표시할 수 없음'이라는 텍스트가 있는 상자](https://developer.android.google.cn/static/partners/glance/images/new_error_layout.png?authuser=19&hl=ko)
Glance를 사용하면 컴포지션 시 개발자가 XML 레이아웃을 대체 수단으로 제공할 수 있습니다. 있습니다 이는 Compose 코드에 오류가 발생했음을 의미합니다. 이 오류 UI 앱 코드에 포착되지 않은 오류가 있는 경우에도 표시됩니다.
class UpgradeWidget : GlanceAppWidget(errorUiLayout = R.layout.error_layout)
이 레이아웃은 사용자가 상호작용할 수 없는 정적 레이아웃이지만 좋습니다. 할 수 있습니다.
<ph type="x-smartling-placeholder">![오류 메시지를 표시하는 제목과 텍스트 필드를 포함합니다.](https://developer.android.google.cn/static/partners/glance/images/custom_error_layout.png?authuser=19&hl=ko)
기본 오류 UI에 작업 추가
Glance 1.1.0부터 Glance를 사용하면 기본 오류 처리 코드를 재정의할 수 있습니다. 이렇게 하면 포착되지 않은 예외나 구성 오류가 있을 수 있습니다.
이 기능을 사용하려면 onCompositionError()
함수를 재정의합니다.
GlanceAppWidget.onCompositionError(
context: Context,
glanceId: GlanceId,
AppWidgetId: Int,
throwable: Throwable
)
이 함수에서 Glance는 오류 처리를 위해 RemoteViews
API로 대체합니다.
이렇게 하면 XML을 사용하여 레이아웃과 작업 핸들러를 지정할 수 있습니다.
다음 예는 오류 UI를 생성하는 방법을 단계별로 보여줍니다. 에는 의견을 보낼 수 있는 버튼이 포함되어 있습니다.
- error_layout.xml 파일 작성
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
style="@style/Widget.MyApplication.AppWidget.Error"
android:id="@android:id/background"
android:layout_width="match_parent"
android:textSize="24sp"
android:layout_height="match_parent"
android:orientation="vertical">
<TextView
android:id="@+id/error_title_view"
android:layout_width="match_parent"
android:textColor="@color/white"
android:textFontWeight="800"
android:layout_height="wrap_content"
android:text="Example Widget Error" />
<LinearLayout
android:layout_width="match_parent"
android:orientation="horizontal"
android:paddingTop="4dp"
android:layout_height="match_parent">
<ImageButton
android:layout_width="64dp"
android:layout_height="64dp"
android:layout_gravity="center"
android:tint="@color/white"
android:id="@+id/error_icon"
android:src="@drawable/heart_broken_fill0_wght400_grad0_opsz24"
/>
<TextView
android:id="@+id/error_text_view"
android:layout_width="wrap_content"
android:textColor="@color/white"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:padding="8dp"
android:textSize="16sp"
android:layout_weight="1"
android:text="Useful Error Message!" />
</LinearLayout>
</LinearLayout>
onCompositionError
함수 재정의
override fun onCompositionError(
context: Context,
glanceId: GlanceId,
AppWidgetId: Int,
throwable: Throwable
) {
val rv = RemoteViews(context.packageName, R.layout.error_layout)
rv.setTextViewText(
R.id.error_text_view,
"Error was thrown. \nThis is a custom view \nError Message: `${throwable.message}`"
)
rv.setOnClickPendingIntent(R.id.error_icon, getErrorIntent(context, throwable))
AppWidgetManager.getInstance(context).updateAppWidget(AppWidgetId, rv)
}
GlanceAppWidgetReceiver
를 참조하는 대기 중인 인텐트 만들기
private fun getErrorIntent(context: Context, throwable: Throwable): PendingIntent {
val intent = Intent(context, UpgradeToHelloWorldPro::class.java)
intent.setAction("widgetError")
return PendingIntent.getBroadcast(context, 0, intent, PendingIntent.FLAG_IMMUTABLE)
}
GlanceAppWidgetReceiver
에서 인텐트를 처리합니다.
override fun onReceive(context: Context, intent: Intent) {
super.onReceive(context, intent)
Log.e("ErrorOnClick", "Button was clicked.");
}