الحاجيات على الروبوت. ميزة نادرة لمعرفة

إنشاء القطعة

1. ملامح مكونات القطعة.
2. ميزات عرض القطعة في شبكة الشاشة.
3. تحديثات القطعة الميزات.

ملامح مكونات القطعة

ميزات عرض القطعة في "شبكة" الشاشة

يجب على كل أداة تعريف minWidth و minHeight ، مع الإشارة إلى الحد الأدنى من المساحة التي يجب أن تستهلكها بشكل افتراضي. عندما يضيف المستخدمون أداة إلى شاشتهم الرئيسية ، سيشغلون عمومًا أكثر من الحد الأدنى للعرض والارتفاع اللذين تحددهما. توفر الشاشات الرئيسية في Android للمستخدمين شبكة من المساحات المتاحة التي يمكنهم من خلالها وضع الأدوات والأيقونات. يمكن أن تختلف هذه الشبكة حسب الجهاز ؛ على سبيل المثال ، توفر العديد من الهواتف شبكة 4 × 4 ، ويمكن للأجهزة اللوحية تقديم شبكة أكبر 8 × 7.

تحديثات القطعة الميزات

حالة القطعة

• للمستخدم المصرح به
• لمستخدم غير مصرح به

override fun onUpdate(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetIds: IntArray
    ) {
        injector.openScope(this, *arrayOf(this))
        // update each of the widgets with the remote adapter
        appWidgetIds
            .forEach {
                updateWidget(context, appWidgetManager, it)
          }
    }

private fun updateWidget(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetId: Int
    ) {
// remoteViews   widgetId
        val remoteViews = RemoteViews(
            context.packageName,
            R.layout.app_widget_layout
...
//        
...
//    remoteViews
updateRemoteAdapter(context, remoteViews, appWidgetId)
 
//   remoteViews 
appWidgetManager.updateAppWidget(appWidgetId, remoteViews)
// collection view  
appWidgetManager.notifyAppWidgetViewDataChanged(
            appWidgetId,
            R.id.lvWidgetItems
        )
    }

private fun updateRemoteAdapter(context: Context, remoteViews: RemoteViews, appWidgetId: Int) {
//   RemoteViewsService   RemoteAdapter   
        val adapterIntent = Intent(context, StolotoAppWidgetRemoteViewsService::class.java).apply {
            putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
        }
        remoteViews.setRemoteAdapter(R.id.lvWidgetItems, adapterIntent)
// actionIntent  pendingIntent      
        val actionIntent = Intent(context, StolotoAppWidgetProvider::class.java).apply {
            action = WIDGET_CLICK_ACTION
            putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
        }
        val pendingIntent = PendingIntent.getBroadcast(
            context, 0, actionIntent,
            PendingIntent.FLAG_UPDATE_CURRENT
        )
// pendingIntent      
        remoteViews.setPendingIntentTemplate(R.id.lvWidgetItems, pendingIntent)
    }

class StolotoAppWidgetRemoteViewsService : RemoteViewsService() {
    override fun onGetViewFactory(intent: Intent): RemoteViewsFactory =
        StolotoAppWidgetRemoteViewsFactory(
            this.applicationContext,
            intent
        )
}

1. onCreate - إنشاء محول.
2. getLoadingView - تقترح الطريقة إعادة العرض ، والذي سيعرضه النظام بدلاً من عناصر القائمة أثناء إنشائها. إذا لم تقم بإنشاء أي شيء هنا ، فسيستخدم النظام بعض طريقة العرض الافتراضية.
3. getViewAt - تقترح الطريقة إنشاء عناصر قائمة. هنا يأتي الاستخدام القياسي لـ RemoteViews.
4. يتم استدعاء onDataSetChanged عند تلقي طلب لتحديث البيانات في القائمة. أولئك. في هذه الطريقة ، نقوم بإعداد البيانات للقائمة. يتم شحذ هذه الطريقة من خلال تنفيذ رمز ثقيل وطويل.
5. يتم استدعاء onDestroy عند حذف القائمة الأخيرة التي يستخدمها المحول (يمكن استخدام محول واحد من قبل عدة قوائم).
6. يعيش RemoteViewsFactory بينما تكون جميع مثيلات القائمة حية ، لذلك يمكننا تخزين البيانات الحالية فيه ، على سبيل المثال ، قائمة العناصر الحالية.

private val widgetItems = ArrayList<WidgetItem>()

override fun onCreate() {
        updateDataSync()
}

   override fun onDataSetChanged() {
        updateDataSync()
    }

 private fun updateDataSync() {
        widgetItems.clear()
        updateProfileSync()
        updateGamesSync()
    }

private fun updateProfileSync() {

val isUserFullAuth = isUserFullAuthInteractor
            .execute()
            .blockingGet()
        if (isUserFullAuth) {
            val profile = getWidgetProfileInteractor
                .execute()
                .onErrorReturn {
                    WidgetProfile()
//           
                }
                .blockingGet()

  if (profile.walletAmount >= 0L) {
                widgetItems.add(
                    WidgetItem.Profile(
                        wallet = profile.walletAmount.toMoneyFormat(),
                        waitingTickets = if (profile.waitingTicketsCount >= 0) profile.waitingTicketsCount.toString() else "",
                        unpaidPrizeAmount = if (profile.unpaidPrizeAmount >= 0) profile.unpaidPrizeAmoount.toMoneyFormat() else ""
                    )
                )
            }
        }
    }

sealed class WidgetItem {
 
    data class Profile(
        val wallet: String,
        val waitingTickets: String,
        val unpaidPrizeAmount: String
    ) : WidgetItem()
 
    data class Game(
        val id: String,
        val iconId: Int,
        val prizeValue: String,
        val date: String
    ) : WidgetItem()
}

override fun getViewAt(position: Int): RemoteViews {
        return when (val item = widgetItems[position]) {
            is WidgetItem.Profile -> {
              RemoteViews(
                        context.packageName,
                        R.layout.item_widget_user_profile
                    ).apply {
                        setTextViewText(R.id.tvWidgetWalletMoney, item.wallet)
                        setTextViewText(R.id.tvWidgetUnpaidCount, item.unpaidPrizeAmount)
                        setTextViewText(R.id.tvWidgetWaitingCount, item.waitingTickets)
                        setOnClickFillInIntent(
                            R.id.llWidgetProfileWallet, Intent().putExtra(
                                StolotoAppWidgetProvider.KEY_PROFILE_OPTIONS,
                                StolotoAppWidgetProvider.VALUE_USER_WALLET
                            )
                        )
                        setOnClickFillInIntent(
                            R.id.llWidgetProfileUnpaid, Intent().putExtra(
                                StolotoAppWidgetProvider.KEY_PROFILE_OPTIONS,
                                StolotoAppWidgetProvider.VALUE_UNPAID_PRIZE
                            )
                        )
                        setOnClickFillInIntent(
                            R.id.llWidgetProfileWaiting, Intent().putExtra(
                                StolotoAppWidgetProvider.KEY_PROFILE_OPTIONS,
                                StolotoAppWidgetProvider.VALUE_WAITING_TICKETS
                            )
                        )
                    }
 
            is WidgetItem.Game -> {
                RemoteViews(
                    context.packageName,
                    R.layout.item_widget_game
                ).apply {
                    setImageViewResource(R.id.ivWidgetGame, item.iconId)
                    setTextViewText(R.id.tvWidgetGamePrize, item.prizeValue)
                    setTextViewText(R.id.tvWidgetGameDate, item.date)
                    setOnClickFillInIntent(
                        R.id.llWidgetGame, Intent().putExtra(
                            StolotoAppWidgetProvider.KEY_GAME_CLICK, item.id
                        )
                    )
                }
            }
        }
    }

تحديث القطعة اليدوي

...
// Intent   AppWidgetManager.ACTION_APPWIDGET_UPDATE
val intentUpdate = Intent(context, StolotoAppWidgetProvider::class.java)
intentUpdate.action = AppWidgetManager.ACTION_APPWIDGET_UPDATE

//    
val ids = AppWidgetManager.getInstance(context)
   .getAppWidgetIds(ComponentName(context, StolotoAppWidgetProvider::class.java))
intentUpdate.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, ids)

//  intent  PendingIntent,  PendingIntent.getBroadcast()
val pendingUpdate = PendingIntent.getBroadcast(
   context,
   appWidgetId,
   intentUpdate,
   PendingIntent.FLAG_UPDATE_CURRENT
)
//  pendingIntent      ‘’
remoteViews.setOnClickPendingIntent(R.id.ivWidgetRefresh, pendingUpdate)
…

1. احصل على النية في "إجراء" مزود onReceive.
2. AppWidgetManager.ACTION_APPWIDGET_UPDATE.
3. استدعاء onUpdate لجميع عناصر واجهة المستخدم المحددة في intent-e.
4. اتصل بالإنترنت للحصول على بيانات جديدة.
5. قم بتحديث البيانات المحلية وعرض بطاقات القائمة الجديدة.

enum class LoadingStep {
   START,
   MIDDLE,
   END
}

if (isFullAuthorized && !widgetLoadingStateInteractor.isWidgetLoading) {
   remoteViews.setViewVisibility(R.id.ivWidgetRefresh, View.VISIBLE)
...
//     ,    
...   
} else {
   remoteViews.setViewVisibility(
       R.id.ivWidgetRefresh,
       if (isFullAuthorized) View.INVISIBLE else View.GONE //       .
   )
}

private fun updateDataSync() {
   when (loadingStep) {
       START -> {
           widgetItems.forEach { it.isLoading = true }
           widgetLoadingStateInteractor.isWidgetLoading = true
           loadingStep = MIDDLE
           widgetManager.updateWidgets()
       }
       MIDDLE -> {
           widgetItems.clear()
           updateProfileSync()
           updateGamesSync()
           widgetLoadingStateInteractor.isWidgetLoading = false
           loadingStep = END
           widgetManager.updateWidgets()
       }
       END -> {
           loadingStep = START
       }
   }
}

1. في نهاية خطوات START و MIDDLE ، أسمي طريقة updateWidgets لتحديث حالة العرض التي يديرها الموفر.
2. START «» , MIDDLE.
3. MIDDLE, «».
4. MIDDLE, END.
5. , END, «». , END loadingStep START.