एक नज़र में जानकारी देखने की सुविधा की मदद से गड़बड़ियां मैनेज करना

Android 15 से, Glance पर गड़बड़ी को ठीक करने की सुविधा को बेहतर बनाने के लिए, एपीआई की सुविधाएं शामिल की गई हैं. इस पेज पर, इन एपीआई के इस्तेमाल से जुड़े सबसे सही तरीके बताए गए हैं.

नॉन-कंपोज़ेबल कॉम्पोनेंट के आस-पास try-catch ब्लॉक का इस्तेमाल करें

Compose, कंपोज़ेबल के आस-पास try-catch ब्लॉक इस्तेमाल करने की अनुमति नहीं देता. हालांकि, यह आपको अपने ऐप्लिकेशन के अन्य लॉजिक को इन ब्लॉक में रैप करने की अनुमति देता है. इससे आपको गड़बड़ी वाले व्यू के लिए, Compose का इस्तेमाल करने की सुविधा मिलती है. इसके बारे में यहां दिए गए उदाहरण में बताया गया है:

provideContent {
    var isError = false
    var data = listOf<String>()
    try {
        val repository = (context.applicationContext as MyApplication).myRepository
        data = repository.loadData()
    } catch (e: Exception) {
        isError = true
        // TODO: handle error
    }

    if (isError) {
        ErrorView()
    } else {
        Content(data)
    }
}
GlanceSnippets.kt

गड़बड़ी का डिफ़ॉल्ट लेआउट

अगर कोई ऐसी गड़बड़ी होती है जिसे पकड़ा नहीं गया है या Compose से जुड़ी कोई गड़बड़ी होती है, तो Glance गड़बड़ी का डिफ़ॉल्ट लेआउट दिखाता है:

Glance की मदद से, डेवलपर कंपोज़िशन फ़ेल होने पर फ़ॉलबैक के तौर पर एक्सएमएल लेआउट उपलब्ध करा सकते हैं. इसका मतलब है कि Compose कोड में कोई गड़बड़ी थी. गड़बड़ी का यह यूज़र इंटरफ़ेस (यूआई) तब भी दिखता है, जब आपके ऐप्लिकेशन के कोड में कोई ऐसी गड़बड़ी हो जिसका पता न चला हो.

class UpgradeWidget : GlanceAppWidget(errorUiLayout = R.layout.error_layout) {
    // ...
}
GlanceSnippets.kt

डिफ़ॉल्ट गड़बड़ी वाले यूज़र इंटरफ़ेस (यूआई) में कार्रवाइयां जोड़ना

Glance 1.1.0 के बाद से, Glance आपको गड़बड़ी को हैंडल करने वाले डिफ़ॉल्ट कोड को बदलने की सुविधा देता है. इस तरह, कंपोज़िशन में किसी गड़बड़ी या अनकैच एक्सेप्शन के मामले में, ऐक्शन कॉलबैक जोड़े जा सकते हैं.

इस सुविधा का इस्तेमाल करने के लिए, onCompositionError() फ़ंक्शन को ओवरराइड करें:

GlanceAppWidget.onCompositionError(
    context: Context,
    glanceId: GlanceId,
    appWidgetId: Int,
    throwable: Throwable
)

इस फ़ंक्शन में, गड़बड़ी को ठीक करने के लिए Glance, RemoteViews एपीआई का इस्तेमाल करता है. इससे एक्सएमएल का इस्तेमाल करके, लेआउट और ऐक्शन हैंडलर तय किए जा सकते हैं.

यहां दिए गए उदाहरणों में, गड़बड़ी का यूज़र इंटरफ़ेस (यूआई) बनाने का तरीका सिलसिलेवार तरीके से बताया गया है. इसमें सुझाव, शिकायत या राय भेजने के लिए एक बटन शामिल है:

1. 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>
   

2. 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)
   }
   GlanceSnippets.kt

3. अपने GlanceAppWidgetReceiver को रेफ़रंस करने वाला एक पेंडिंग इंटेंट बनाएं:

   private fun getErrorIntent(context: Context, throwable: Throwable): PendingIntent {
       val intent = Intent(context, UpgradeToHelloWorldPro::class.java)
       intent.action = "widgetError"
       return PendingIntent.getBroadcast(context, 0, intent, PendingIntent.FLAG_IMMUTABLE)
   }
   GlanceSnippets.kt

4. अपने GlanceAppWidgetReceiver में इंटेंट को मैनेज करें:

   override fun onReceive(context: Context, intent: Intent) {
       super.onReceive(context, intent)
       Log.e("ErrorOnClick", "Button was clicked.")
   }
   GlanceSnippets.kt