Share
Embed
Widget開発再訪
DroidKaigi2018, Room 2 - 2018/02/08 14:00-14:30
https://droidkaigi.jp/2018/timetable?session=16949
ymnder
February 05, 2018
Transcript
126 slides
-
Today's menu 1. About Widget 2. Widget Design 3. Let's
make Widget 4. New API 3 -
What Widget • WidgetϛχΞϓϦͰ͋Δ • ϝΠϯͷΞϓϦʹόϯυϧͯ͠ఏڙ͞ΕΔ • ΞϓϦͷίΞػೳΛΞϓϦͷ֎Ͱ͑Δ • ΞϓϦͷػೳίϯςϯπʹϗʔϜը໘͔Β৮ΕΔ
• ϗʔϜը໘ͰίϯςϯπΛʹ͢Δػձ͕૿͑Δ • ΞϓϦΛ։͔ͳͯ͘ΞΫηεͰ͖Δʂʂ 5 -
Widget Category ᶃ Information widgets ᶄ Collection widgets ᶅ Control
widgets ᶆ Hybrid widgets ΨΠυϥΠϯɿhttps://material.io/guidelines/components/widgets.html#widgets-types-of-widgets چΨΠυϥΠϯɿhttps://developer.android.com/design/patterns/widgets.html 14 -
Widget Category ᶃ Information widgets ᶄ Collection widgets ᶅ Control
widgets ᶆ Hybrid widgets ΨΠυϥΠϯɿhttps://material.io/guidelines/components/widgets.html#widgets-types-of-widgets چΨΠυϥΠϯɿhttps://developer.android.com/design/patterns/widgets.html 15 -
Widget Category ᶃ Information widgets ᶄ Collection widgets ᶅ Control
widgets ᶆ Hybrid widgets ΨΠυϥΠϯɿhttps://material.io/guidelines/components/widgets.html#widgets-types-of-widgets چΨΠυϥΠϯɿhttps://developer.android.com/design/patterns/widgets.html 17 -
Widget Category ᶃ Information widgets ᶄ Collection widgets ᶅ Control
widgets ᶆ Hybrid widgets ΨΠυϥΠϯɿhttps://material.io/guidelines/components/widgets.html#widgets-types-of-widgets چΨΠυϥΠϯɿhttps://developer.android.com/design/patterns/widgets.html 19 -
Widget Category ᶃ Information widgets ᶄ Collection widgets ᶅ Control
widgets ᶆ Hybrid widgets ΨΠυϥΠϯɿhttps://material.io/guidelines/components/widgets.html#widgets-types-of-widgets چΨΠυϥΠϯɿhttps://developer.android.com/design/patterns/widgets.html 21 -
Layout ᶃ Ұߦܕ • ҰߦͰχϡʔεΛίϯύΫτʹදࣔ ᶄ Ϧετܕ • هࣄΛϦετͰදࣔ͢Δ(GridΑΓList͕ଟ͍) ᶅ
Υʔϧϖʔύʔܕ • ڧௐ͍ͨࣸ͠ਅΛนࢴͷΑ͏ʹදࣔ͢Δ 24 -
Layout ᶃ Ұߦܕ • ҰߦͰχϡʔεΛίϯύΫτʹදࣔ ᶄ Ϧετܕ • هࣄΛϦετͰදࣔ͢Δ(GridΑΓList͕ଟ͍) ᶅ
Υʔϧϖʔύʔܕ • ڧௐ͍ͨࣸ͠ਅΛนࢴͷΑ͏ʹදࣔ͢Δ 25 -
Layout ᶃ Ұߦܕ • ҰߦͰχϡʔεΛίϯύΫτʹදࣔ ᶄ Ϧετܕ • هࣄΛϦετͰදࣔ͢Δ(GridΑΓList͕ଟ͍) ᶅ
Υʔϧϖʔύʔܕ • ڧௐ͍ͨࣸ͠ਅΛนࢴͷΑ͏ʹදࣔ͢Δ 27 -
Layout ᶃ Ұߦܕ • ҰߦͰχϡʔεΛίϯύΫτʹදࣔ ᶄ Ϧετܕ • هࣄΛϦετͰදࣔ͢Δ(GridΑΓList͕ଟ͍) ᶅ
Υʔϧϖʔύʔܕ • ڧௐ͍ͨࣸ͠ਅΛนࢴͷΑ͏ʹදࣔ͢Δ 29 -
Configuration ઃఆՄೳͳ߲ҎԼͷΑ͏ͳͷ͕ఏڙ͞Ε͍ͯΔ • ৭ɿന, ࠇ… • ߋ৽සɿ30min, 1h, more… •
χϡʔεͷ༰ɿtop, ranking… 31 -
Widget Classes • AppWidgetService • WidgetIdͷൃߦϥϯνϟʔͷϦΫΤετΛߦ͏ • AppWidgetHost • WidgetͱϗʔϜը໘ͷཱͪΛߦ͏
• AppWidgetHostView • WidgetΛදࣔ͢ΔͨΊͷදࣔྖҬΛఏڙ͢Δ • AppWidgetManager • Widgetͷঢ়ଶΛߋ৽ͨ͠ΓɺใΛऔಘ͢ΔཧΫϥε • AppWidgetProvider • Widgetͷ֤छͷΠϕϯτΛϋϯυϦϯά͢Δ • AppWidgetProviderInfo • WidgetͷϝλσʔλΛѻ͏ 34 -
Widget Classes • AppWidgetService • WidgetIdͷൃߦϥϯνϟʔͷϦΫΤετΛߦ͏ • AppWidgetHost • WidgetͱϗʔϜը໘ͷཱͪΛߦ͏
• AppWidgetHostView • WidgetΛදࣔ͢ΔͨΊͷදࣔྖҬΛఏڙ͢Δ • AppWidgetManager • Widgetͷঢ়ଶΛߋ৽ͨ͠ΓɺใΛऔಘ͢ΔཧΫϥε • AppWidgetProvider • Widgetͷ֤छͷΠϕϯτΛϋϯυϦϯά͢Δ • AppWidgetProviderInfo • WidgetͷϝλσʔλΛѻ͏ 35 ←࣮Ͱ͏ -
Widget Classes: Simplify • AppWidgetManager • WidgetͷViewͷߋ৽Λߦ͏ • AppWidgetProvider •
Widgetͷߋ৽Λϋϯυϧ͢Δ • AppWidgetProviderInfo • WidgetͷجຊใΛxmlʹهड़͢Δ • xml/layout • WidgetͷϨΠΞτɺ௨ৗͷϨΠΞτͱ֓Ͷಉ͡ 36 -
How to make it: Simplify ᶃ manifestʹreceiverΛՃ ᶄ AppWidgetProviderInfoͰWidgetใΛઃఆ ᶅ
AppWidgetProviderͰRemoteViewΛੜˍUpdate 37 -
View: Layout • FrameLayout • LinearLayout • RelativeLayout • GridLayout
※ConstraintLayout͑ͳ͍ʂʂ 46 -
View: جຊతͳͷ • Button • ImageButton • ImageView • ProgressBar
• TextView • ViewFlipper 47 -
View: λΠϚʔܥ • Chronometer -> λΠϚʔΛͭ͘Δ • TextClock -> σδλϧ࣌ܭΛදࣔͤ͞Δ
• AnalogClock -> deprecated 48 -
onRecieve 58 public void onReceive(Context context, Intent intent) { String
action = intent.getAction(); if (AppWidgetManager.ACTION_APPWIDGET_UPDATE.equals(action)) { this.onUpdate(…); } else if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) { this.onDeleted(…); } else if (AppWidgetManager.ACTION_APPWIDGET_OPTIONS_CHANGED.equals(action)) { this.onAppWidgetOptionsChanged(…); } else if (AppWidgetManager.ACTION_APPWIDGET_ENABLED.equals(action)) { this.onEnabled(…); } else if (AppWidgetManager.ACTION_APPWIDGET_DISABLED.equals(action)) { this.onDisabled(…); } else if (AppWidgetManager.ACTION_APPWIDGET_RESTORED.equals(action)) { this.onRestored(…); this.onUpdate(…); } } -
AppWidgetProviderͷϥΠϑαΠΫϧ • onEnabled • onUpdated • onDeleted • onDisabled •
onAppWidgetOptionsChanged • onRestored 59 -
updatePeriodMills • WidgetͷΞοϓσʔτִؒɺProviderInfoͰࢦఆ͢Δ • ࠷ߋ৽ִؒ30minͰ͋Δ • 0ҎԼΛࢦఆ͢ΔͱݺΕͳ͘ͳΔ • 30minະຬͷ߹ɺ30minʹ͞ΕΔ •
ߋ৽ִؒΛ͍ͨ͘͠߹AlarmManagerͳͲΛ͏ • updatePeriodMills0Λࢦఆ͓ͯ͘͜͠ͱ 63 -
AppWidgetProviderͷϥΠϑαΠΫϧ • onEnabled • onUpdated • onDeleted • onDisabled •
onAppWidgetOptionsChanged • onRestored 64 -
onAppWidgetOptionsChanged • ϦαΠζ͞Εͨͱ͖ʹݺΕΔ • added in API level 16 •
ը໘αΠζΛdpͰऔಘͰ͖Δ • খ͘͞ͳͬͨͱ͖ʹཁૉΛඇදࣔͨ͠ΓͰ͖Δ •OPTION_MIN_WIDTHɿݱࡏͷwidthͷԼݶ •OPTION_MAX_WIDTHɿݱࡏͷwidthͷ্ݶ •OPTION_MIN_HEIGHTɿݱࡏͷheightͷԼݶ •OPTION_MAX_HEIGHTɿݱࡏͷheightͷ্ݶ 65 -
onRestored • ޙʹonUpdateΛݺͼग़͢ • added in API level 21 •
backup͔Βprovider͕ϦετΞ͞Εͨͱ͖ʹݺΕΔ • widgetʹඥ͍ͨσʔλΛอ͍࣋ͨ͠߹ʹ͏ • ݹ͍id͔Β৽͍͠idͷҾ͖ܧ͗Λߦ͏ • widgetIdͱʁʔʼAppendixʂ 66 -
࣮ 68 class SampleAppWidgetProvider : AppWidgetProvider() { override fun onUpdate(…)
{ for (appWidgetId in appWidgetIds) { val intent = Intent(context, MainActivity::class.java) val pendingIntent = PendingIntent.getActivity(context, 0, intent, 0) val views = RemoteViews(context.packageName, R.layout.widget_container) views.setTextViewText(R.id.textWidget, "Hello:)") views.setOnClickPendingIntent(R.id.button, pendingIntent) appWidgetManager.updateAppWidget(appWidgetId, views) } } } -
ղઆ 69 //RemoteViewsʹ༻͍ͨ͠ϨΠΞτΛ͢ val views = RemoteViews(context.packageName, R.layout.widget_container) //TextΛಈతʹॻ͖͑Δ views.setTextViewText(R.id.textWidget,
"Hello:)") //Click࣌ͷಈ࡞Ληοτ͍ͨ͠ͱ͖ views.setOnClickPendingIntent(R.id.button, pendingIntent) -
࣮ɿListViewͷέʔε 71 fun updateWidget(context: Context, appWidgetId: Int) { val manager
= AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widget_container) // ListItemʹߋ৽௨Λߦ͏ͨΊͷintentΛ࡞ val intent = Intent(context, SampleWidgetService::class.java) .putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId) remoteViews.setRemoteAdapter(R.id.widgetListView, intent) // ListItem͕ۭͩͬͨ߹ͷEmptyදࣔ remoteViews.setEmptyView(R.id.widgetListView, android.R.id.empty) // ListItemΛλοϓͨ͠ͱ͖ͷintentΛηοτ // ListItemͷଆͰηοτ͢ΔͷͰͳ͘ɺ͜͜Ͱηοτ͢Δ val onClickIntent = Intent(context, DetailActivity::class.java) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val onClickPendingIntent = PendingIntent.getActivity(context, 0, onClickIntent, PendingIntent.FLAG_UPDATE_CURRENT) remoteViews.setPendingIntentTemplate(R.id.widgetListView, onClickPendingIntent) manager.updateAppWidget(appWidgetId, remoteViews) } -
࣮ɿListViewͷέʔε 72 fun updateWidget(context: Context, appWidgetId: Int) { val manager
= AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widget_container) // ListItemʹߋ৽௨Λߦ͏ͨΊͷintentΛ࡞ val intent = Intent(context, SampleWidgetService::class.java) .putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId) remoteViews.setRemoteAdapter(R.id.widgetListView, intent) // ListItem͕ۭͩͬͨ߹ͷEmptyදࣔ remoteViews.setEmptyView(R.id.widgetListView, android.R.id.empty) // ListItemΛλοϓͨ͠ͱ͖ͷintentΛηοτ // ListItemͷଆͰηοτ͢ΔͷͰͳ͘ɺ͜͜Ͱηοτ͢Δ val onClickIntent = Intent(context, DetailActivity::class.java) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val onClickPendingIntent = PendingIntent.getActivity(context, 0, onClickIntent, PendingIntent.FLAG_UPDATE_CURRENT) remoteViews.setPendingIntentTemplate(R.id.widgetListView, onClickPendingIntent) manager.updateAppWidget(appWidgetId, remoteViews) } -
࣮ɿListViewͷέʔε 73 fun updateWidget(context: Context, appWidgetId: Int) { val manager
= AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widget_container) // ListItemʹߋ৽௨Λߦ͏ͨΊͷintentΛ࡞ val intent = Intent(context, SampleWidgetService::class.java) .putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId) remoteViews.setRemoteAdapter(R.id.widgetListView, intent) // ListItem͕ۭͩͬͨ߹ͷEmptyදࣔ remoteViews.setEmptyView(R.id.widgetListView, android.R.id.empty) // ListItemΛλοϓͨ͠ͱ͖ͷintentΛηοτ // ListItemͷଆͰηοτ͢ΔͷͰͳ͘ɺ͜͜Ͱηοτ͢Δ val onClickIntent = Intent(context, DetailActivity::class.java) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val onClickPendingIntent = PendingIntent.getActivity(context, 0, onClickIntent, PendingIntent.FLAG_UPDATE_CURRENT) remoteViews.setPendingIntentTemplate(R.id.widgetListView, onClickPendingIntent) manager.updateAppWidget(appWidgetId, remoteViews) } -
࣮ɿListView(Item)ͷέʔε 74 override fun getViewAt(position: Int): RemoteViews { val rv
= RemoteViews(context.packageName, R.layout.list_item) rv.setTextViewText(R.id.list_text, items[position]) //͜͜ͰIntentΛ٧ΊΔɻ͜ͷintent͜ͷΫϥεͷݺͼग़͠ݩ͞ΕΔ //ListItemͷ࣋ͭσʔλ͕ཉ͍͠߹͜ͷintentʹ٧ΊΔ rv.setOnClickFillInIntent(R.id.list_container, createIntent(position)) return rv } -
AppWidgetProviderInfo WidgetͦͷͷͷઃఆΛxmlͰهड़͢Δ 76 <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minHeight="40dp" android:minResizeWidth="40dp" android:minWidth="250dp" android:resizeMode="horizontal|vertical" android:updatePeriodMillis="1800000"
android:configure="com.example.ymnd.widgetsampleapp.ConfigureActivity" android:widgetCategory="home_screen|keyguard"> </appwidget-provider> -
ը໘ͷେ͖͞Λࢦఆ͢Δͷ • int minWidth / int minHeight • σϑΥϧτͷ෯ͱߴ͞ΛdpͰࢦఆ͢Δ •
int minResizeWidth / int minResizeHeight • ϦαΠζͷԼݶΛdpͰࢦఆ͢Δ • minResizeWidth <= minWidth • minResizeHeight <= minHeight • int resizeMode(horizontal|vertical or none) • ͲͷํͷϦαΠζΛڐՄ͢Δ͔ 77 -
ϨΠΞτ • int initialKeyguardLayout • KeyGuardʹදࣔͨ͠ͱ͖ͷϨΠΞτΛࢦఆ͢Δ • int initialLayout •
ΟδΣοτͷϨΠΞτΛࢦఆ͢Δ • int widgetCategory(home_screen|keyguard) • ΟδΣοτΛͲ͜ʹஔ͚Δ͔ࢦఆ͢Δ • keyguardAndroid 5.0Ҏ্Ͱ༻Ͱ͖ͳ͍ 79 -
ը໘ߋ৽ܥ • int updatePeriodMillis • ϛϦඵͰWidgetͷߋ৽ִؒΛࢦఆ͢Δ(30minҎ্) • ComponentName configure •
WidgetΛՃͨ͠߹ʹࢦఆͨ͠ActivityΛݺͼग़ͯ͘͠ΕΔ • onUpdateݺΕͳ͍ͷͰผ్ݺͿඞཁ͕͋Δ • Widget Dialog͔Βઃஔͨ͠ͱ͖ʹݺΕͳ͍ • int autoAdvanceViewId • StackViewͳͲࢠཁૉΛ࣋ͭϨΠΞτͷidΛࢦఆ͢Δ • Ϣʔβʔͷૢ࡞͕ͳͯࣗ͘ಈͰViewΛਐΊΔ 80 -
configureิ • ίϯϑΟάը໘ʹ༻͢ΔActivitymanifestʹintent- filterΛηοτ͢Δ 81 <activity android:name=".ColorConfigureActivity" android:theme="@style/TransParentTheme"> <intent-filter> <action
android:name="android.appwidget.action.APPWIDGET_CONFIGURE" /> </intent-filter> </activity> -
ProviderͱProviderInfoͷิ • ProviderͱProviderInfomanifestͰҎԼͷΑ͏ʹࢦఆ ͢Δ 82 <receiver android:name=".ResizableAppWidget"> <intent-filter> <action android:name="android.appwidget.action.APPWIDGET_UPDATE"
/> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/resizable_app_widget_info" /> </receiver> -
࣮ 87 val widgetManager = AppWidgetManager.getInstance(this) val provider = ComponentName(this,
SampleAppWidgetProvider::class.java) if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return if (widgetManager.isRequestPinAppWidgetSupported) { val callbackIntent = Intent(this, SubActivity::class.java) val successCallback = PendingIntent.getActivity(this, 0, callbackIntent, 0) val extras = Bundle() val remoteViews = RemoteViews(this.packageName, R.layout.widget_container) remoteViews.setTextViewText(R.id.button, "ͯ͢ͱ") extras.putParcelable(EXTRA_APPWIDGET_PREVIEW, remoteViews) widgetManager.requestPinAppWidget(provider, extras, null) } -
࣮ 88 val widgetManager = AppWidgetManager.getInstance(this) val provider = ComponentName(this,
SampleAppWidgetProvider::class.java) if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return if (widgetManager.isRequestPinAppWidgetSupported) { val callbackIntent = Intent(this, SubActivity::class.java) val successCallback = PendingIntent.getActivity(this, 0, callbackIntent, 0) val extras = Bundle() val remoteViews = RemoteViews(this.packageName, R.layout.widget_container) remoteViews.setTextViewText(R.id.button, "ͯ͢ͱ") extras.putParcelable(EXTRA_APPWIDGET_PREVIEW, remoteViews) widgetManager.requestPinAppWidget(provider, extras, null) } -
࣮ 90 val widgetManager = AppWidgetManager.getInstance(this) val provider = ComponentName(this,
SampleAppWidgetProvider::class.java) if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return if (widgetManager.isRequestPinAppWidgetSupported) { val callbackIntent = Intent(this, SubActivity::class.java) val successCallback = PendingIntent.getActivity(this, 0, callbackIntent, 0) val extras = Bundle() val remoteViews = RemoteViews(this.packageName, R.layout.widget_container) remoteViews.setTextViewText(R.id.button, "ͯ͢ͱ") extras.putParcelable(EXTRA_APPWIDGET_PREVIEW, remoteViews) widgetManager.requestPinAppWidget(provider, extras, null) } -
࣮ 92 val widgetManager = AppWidgetManager.getInstance(this) val provider = ComponentName(this,
SampleAppWidgetProvider::class.java) if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return if (widgetManager.isRequestPinAppWidgetSupported) { val callbackIntent = Intent(this, SubActivity::class.java) val successCallback = PendingIntent.getActivity(this, 0, callbackIntent, 0) val extras = Bundle() val remoteViews = RemoteViews(this.packageName, R.layout.widget_container) remoteViews.setTextViewText(R.id.button, "ͯ͢ͱ") extras.putParcelable(EXTRA_APPWIDGET_PREVIEW, remoteViews) widgetManager.requestPinAppWidget(provider, extras, null) } -
ղઆ: successCallback • ઃஔޙʹݺͿcallbackΛPendingIntentͱͯ͠ηοτ • callbackWidgetͷՃμΠΞϩάͰඞཁͱͳΔ • ࣗಈͰՃorखಈͰՃͷ̎௨Γ͋Δ • ࣗಈͰՃ
• ΞϓϦͷը໘͔ΒભҠ͠ͳ͍ • खಈͰՃ • ϗʔϜϥϯνϟʔʹભҠ • ࣗͷΞϓϦʹͬͯ͜ͳ͍ • BroadcastͳͲΛ༻ͯ͠෮ؼͯ͠Β͏ 93 -
ղઆ: successCallback • ઃஔޙʹݺͿcallbackΛPendingIntentͱͯ͠ηοτ • callbackWidgetͷՃμΠΞϩάͰඞཁͱͳΔ • ࣗಈͰՃorखಈͰՃͷ̎௨Γ͋Δ • ࣗಈͰՃ
• ΞϓϦͷը໘͔ΒભҠ͠ͳ͍ • खಈͰՃ • ϗʔϜϥϯνϟʔʹભҠ • ࣗͷΞϓϦʹͬͯ͜ͳ͍ • BroadcastͳͲΛ༻ͯ͠෮ؼͯ͠Β͏ 94 -
ղઆ: successCallback • ઃஔޙʹݺͿcallbackΛPendingIntentͱͯ͠ηοτ • callbackWidgetͷՃμΠΞϩάͰඞཁͱͳΔ • ࣗಈͰՃorखಈͰՃͷ̎௨Γ͋Δ • ࣗಈͰՃ
• ΞϓϦͷը໘͔ΒભҠ͠ͳ͍ • खಈͰՃ • ϗʔϜϥϯνϟʔʹભҠ • ࣗͷΞϓϦʹͬͯ͜ͳ͍ • BroadcastͳͲΛ༻ͯ͠෮ؼͯ͠Β͏ 95 -
࣮ 96 val widgetManager = AppWidgetManager.getInstance(this) val provider = ComponentName(this,
SampleAppWidgetProvider::class.java) if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return if (widgetManager.isRequestPinAppWidgetSupported) { val callbackIntent = Intent(this, SubActivity::class.java) val successCallback = PendingIntent.getActivity(this, 0, callbackIntent, 0) val extras = Bundle() val remoteViews = RemoteViews(this.packageName, R.layout.widget_container) remoteViews.setTextViewText(R.id.button, "ͯ͢ͱ") extras.putParcelable(EXTRA_APPWIDGET_PREVIEW, remoteViews) widgetManager.requestPinAppWidget(provider, extras, null) } -
ղઆ: extras • custom previewΛηοτͰ͖Δ • previewImageͱҟͳΔ • RemoteViewsΛಈతʹΧελϜͯ͠ηοτՄೳ •
preview༻Ͱ͋ΓɺonUpdate͞ΕΔࡍʹߋ৽͞ΕΔ 97 -
࣮ 98 val widgetManager = AppWidgetManager.getInstance(this) val provider = ComponentName(this,
SampleAppWidgetProvider::class.java) if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return if (widgetManager.isRequestPinAppWidgetSupported) { val callbackIntent = Intent(this, SubActivity::class.java) val successCallback = PendingIntent.getActivity(this, 0, callbackIntent, 0) val extras = Bundle() val remoteViews = RemoteViews(this.packageName, R.layout.widget_container) remoteViews.setTextViewText(R.id.button, "ͯ͢ͱ") extras.putParcelable(EXTRA_APPWIDGET_PREVIEW, remoteViews) widgetManager.requestPinAppWidget(provider, extras, null) } -
whoami • twitter:@ymnd, github:@ymnder • Application Engineer • Android ܦిࢠ൛ΞϓϦ
• Android ࢴ໘ϏϡʔΞʔΞϓϦ • ٕज़ॻయ̐Ͱܦిࢠ൛ͷݟΛ·ͱΊͨຊΛग़͠·͢ 104 -
How to Calculate minWidth and minHeight WidgetͷminWidth/minHeightͷࢉग़ࣜ 70 × cell
− 30 = size ྫɿ1ߦ2ྻͷwidgetΛ࡞͢Δ߹ minHeight =70 x 1 - 30 = 40 minWidth = 70 x 2 - 30 = 110 107 -
How to Calculate minWidth and minHeight • API14ҎલͰܭࢉํ๏͕Ξοϓσʔτ͞Εͨʂ • targetSDK͕API14Ҏ্ͷ߹ɺϗʔϜը໘ͷΟδΣ
οτͷ֤ʹϚʔδϯ͕ࣗಈతʹՃ͞ΕΔ • ͦͷͨΊɺAndroid4.0Ҏ্Ͱwidgetʹ༧Ί༨നΛ Ճ͢Δඞཁͳ͍ 108 -
Config Best Practice(from Material Design Guideline) • config؆ܿʹ͠ɺ̎ʙ̏Ҏ্ͷઃఆ߲Λઃ͚ͳ͍ • ϑϧεΫϦʔϯΑΓμΠΞϩάͰબͯ͠Β͏
• WidgetͷઃఆͰ͋Δ͜ͱ͕͔Γ͍͢ • setupޙWidgetʹઃఆ༻ͷϘλϯΛදࣔ͠ͳ͍ 109 -
how is appWidgetId created? • appWidgetIdWidgetΛߋ৽͢Δͱ͖ʹ༻͍ΔID • ͜ͷID͕ͲͷΑ͏ʹৼΒΕ͍ͯΔ͔͕ؾʹͳΔ • ຊʹϢχʔΫͳͷʁ
• AppWidgetHost.java#allocateAppWidgetId 110 //Get a appWidgetId for a host in the calling process. //@return a appWidgetId public int allocateAppWidgetId() {…} -
AppWidgetServiceImpl.java 111 public int allocateAppWidgetId(String callingPackage, int hostId) { ...
if (mNextAppWidgetIds.indexOfKey(userId) < 0) { // ॳظԽॲཧ // AppWidgetManager.INVALID_APPWIDGET_ID0 // Widget1͔Β࠾൪͞Ε͍ͯ͘ɻ mNextAppWidgetIds.put(userId, AppWidgetManager.INVALID_APPWIDGET_ID + 1); } final int appWidgetId = incrementAndGetAppWidgetIdLocked(userId); ... } -
ͲͷΑ͏ʹ൪߸͕ৼΒΕΔ͔ʁ • mNextAppWidgetIds • {userId, appWidgetId}ͷϖΞͰid͕อଘ͞ΕΔ • ಡΈग़ͨ͠ޙɺ+1ͯ͠࠶อଘ͍ͯ͠Δ 112 private
final SparseIntArray mNextAppWidgetIds = new SparseIntArray(); final int appWidgetId = peekNextAppWidgetIdLocked(userId) + 1; return mNextAppWidgetIds.get(userId); -
requestPinAppWidget & isRequestPinAppWidgetSupportedͷฦΓ • isRequestPinAppWidgetSupported • Return {@code TRUE} if
the default launcher supports • updateAppWidget • {@code TRUE} if the launcher supports this feature. Note the API will return without waiting for the user to respond, so getting {@code TRUE} from this API does not mean the shortcut is pinned. {@code FALSE} if the launcher doesn't support this feature. • ͜ΕʹͲΜͳҧ͍͕͋Δͷ͔ 114 -
isRequestPinAppWidgetSupportedͷฦΓ AppWidgetManager → AppWidgetServiceImpl.java#isRequestPinAppWidgetSupported → ShortcutService.java#isRequestPinItemSupported → ShortcutRequestPinProcessor.java#isRequestPinItemSupported → ShortcutRequestPinProcessor.java#getRequestPinConfirmationActivity
ShortcutService.java#getRequestPinConfirmationActivity 115 -
requestPinAppWidgetͷฦΓ AppWidgetManager → AppWidgetServiceImpl → ShortcutService#requestPinAppWidget → ShortcutService.java#requestPinItem → ShortcutRequestPinProcessor.java#requestPinItemLocked
→ ShortcutService.java#getRequestPinConfirmationActivity 117 -
callbackͲͷλΠϛϯάͰݺΕΔ͔ʁ → LauncherApps.java#PinItemRequest ޭ࣌ʹacceptΛݺͿ → ShortcutRequestPinProcessor.java#PinAppWidgetRequestInner → ShortcutRequestPinProcessor.java#PinItemRequestInner ͜͜Ͱacceptͷத͕࣮͞Ε͍ͯΔ →
ShortcutRequestPinProcessor.java#directPinShortcut ྫ֎ΛΩϟον͍ͯͯ͠ɺ࡞Ͱ͖ͳ͔ͬͨ߹falseΛฦ͢ tryAccept͕falseʹͳΓɺίʔϧόοΫ͕࣮ߦ͞Εͳ͍ → ShortcutService.java#fixUpIncomingShortcutInfo 122 -
callbackͲͷλΠϛϯάͰݺΕΔ͔ʁʢऴʣ • tryAccept͕trueͷͱ͖sendResultIntent͕࣮ߦ͞ΕΔ • ͢ͳΘͪ͜͜Ͱcallback͕࣮ߦ͞ΕΔ • ࣦഊ࣌Կ͞Εͳ͍Ͱfalse͕ฦΔ 123 // PinItemRequestInner#accept
// Pin it and send the result intent. if (tryAccept()) { mProcessor.sendResultIntent(mResultIntent, extras); return true; } else { return false; }