[{"data":1,"prerenderedAt":1401},["ShallowReactive",2],{"navigation":3,"\u002Fguide\u002Fsetup\u002Fandroid":252,"\u002Fguide\u002Fsetup\u002Fandroid-surround":1397},[4,89,128,171,213,217,248],{"title":5,"path":6,"stem":7,"children":8,"icon":88},"Guide","\u002Fguide","1.guide\u002F01.index",[9,10,14,18,22,26,30,34,38,42,73],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"Install","\u002Fguide\u002Finstall","1.guide\u002F02.install",{"title":15,"path":16,"stem":17},"First widget","\u002Fguide\u002Ffirst-widget","1.guide\u002F03.first-widget",{"title":19,"path":20,"stem":21},"Concepts","\u002Fguide\u002Fconcepts","1.guide\u002F05.concepts",{"title":23,"path":24,"stem":25},"Apple data transport","\u002Fguide\u002Ftransport","1.guide\u002F06.transport",{"title":27,"path":28,"stem":29},"Doctor","\u002Fguide\u002Fdoctor","1.guide\u002F07.doctor",{"title":31,"path":32,"stem":33},"CLI","\u002Fguide\u002Fcli","1.guide\u002F08.cli",{"title":35,"path":36,"stem":37},"Core vs extended","\u002Fguide\u002Ftiers","1.guide\u002F09.tiers",{"title":39,"path":40,"stem":41},"Troubleshooting","\u002Fguide\u002Ftroubleshooting","1.guide\u002F10.troubleshooting",{"title":43,"path":44,"stem":45,"children":46,"icon":72},"Platform setup","\u002Fguide\u002Fsetup","1.guide\u002F12.setup\u002F1.index",[47,48,52,56,60,64,68],{"title":43,"path":44,"stem":45},{"title":49,"path":50,"stem":51},"Android setup","\u002Fguide\u002Fsetup\u002Fandroid","1.guide\u002F12.setup\u002F2.android",{"title":53,"path":54,"stem":55},"iOS setup","\u002Fguide\u002Fsetup\u002Fios","1.guide\u002F12.setup\u002F3.ios",{"title":57,"path":58,"stem":59},"macOS setup","\u002Fguide\u002Fsetup\u002Fmacos","1.guide\u002F12.setup\u002F4.macos",{"title":61,"path":62,"stem":63},"Windows setup","\u002Fguide\u002Fsetup\u002Fwindows","1.guide\u002F12.setup\u002F5.windows",{"title":65,"path":66,"stem":67},"Linux setup","\u002Fguide\u002Fsetup\u002Flinux","1.guide\u002F12.setup\u002F6.linux",{"title":69,"path":70,"stem":71},"Desktop webview","\u002Fguide\u002Fsetup\u002Fdesktop","1.guide\u002F12.setup\u002F7.desktop","i-lucide-monitor-smartphone",{"title":74,"icon":75,"path":76,"stem":77,"children":78,"page":87},"Recipes","i-lucide-chef-hat","\u002Fguide\u002Frecipes","1.guide\u002F13.recipes",[79,83],{"title":80,"path":81,"stem":82},"Multi-widget","\u002Fguide\u002Frecipes\u002Fmulti-widget","1.guide\u002F13.recipes\u002F4.multi-widget",{"title":84,"path":85,"stem":86},"Testing your widget","\u002Fguide\u002Frecipes\u002Ftesting","1.guide\u002F13.recipes\u002F5.testing",false,"i-lucide-rocket",{"title":90,"path":91,"stem":92,"children":93,"icon":127},"Elements","\u002Felements","2.elements\u002F1.index",[94,95,99,103,107,111,115,119,123],{"title":90,"path":91,"stem":92},{"title":96,"path":97,"stem":98},"Layout elements","\u002Felements\u002Flayout","2.elements\u002F2.layout",{"title":100,"path":101,"stem":102},"Text elements","\u002Felements\u002Ftext","2.elements\u002F3.text",{"title":104,"path":105,"stem":106},"Media elements","\u002Felements\u002Fmedia","2.elements\u002F4.media",{"title":108,"path":109,"stem":110},"Data elements","\u002Felements\u002Fdata","2.elements\u002F5.data",{"title":112,"path":113,"stem":114},"Interactive elements","\u002Felements\u002Finteractive","2.elements\u002F6.interactive",{"title":116,"path":117,"stem":118},"Spacing elements","\u002Felements\u002Fspacing","2.elements\u002F7.spacing",{"title":120,"path":121,"stem":122},"Style","\u002Felements\u002Fstyle","2.elements\u002F8.style",{"title":124,"path":125,"stem":126},"Colors","\u002Felements\u002Fcolors","2.elements\u002F9.colors","i-lucide-blocks",{"title":129,"path":130,"stem":131,"children":132,"icon":170},"Features","\u002Ffeatures","2.features\u002F01.index",[133,134,138,142,146,150,154,158,162,166],{"title":129,"path":130,"stem":131},{"title":135,"path":136,"stem":137},"Dynamic Island","\u002Ffeatures\u002Fdynamic-island","2.features\u002F02.dynamic-island",{"title":139,"path":140,"stem":141},"Interactive widgets","\u002Ffeatures\u002Finteractive","2.features\u002F03.interactive",{"title":143,"path":144,"stem":145},"Live activities","\u002Ffeatures\u002Flive-activities","2.features\u002F04.live-activities",{"title":147,"path":148,"stem":149},"Timelines and transitions","\u002Ffeatures\u002Ftimelines","2.features\u002F05.timelines",{"title":151,"path":152,"stem":153},"Remote data","\u002Ffeatures\u002Fremote-data","2.features\u002F06.remote-data",{"title":155,"path":156,"stem":157},"Widget updater","\u002Ffeatures\u002Fwidget-updater","2.features\u002F07.widget-updater",{"title":159,"path":160,"stem":161},"Instances","\u002Ffeatures\u002Finstances","2.features\u002F08.instances",{"title":163,"path":164,"stem":165},"Conditions, lists and templates","\u002Ffeatures\u002Fdynamic-content","2.features\u002F09.dynamic-content",{"title":167,"path":168,"stem":169},"Images","\u002Ffeatures\u002Fimages","2.features\u002F10.images","i-lucide-sparkles",{"title":172,"icon":173,"path":174,"stem":175,"children":176,"page":87},"API","i-lucide-file-code","\u002Fapi","3.api",[177,181,185,189,193,197,201,205,209],{"title":178,"path":179,"stem":180},"JavaScript API","\u002Fapi\u002Fjs","3.api\u002F1.js",{"title":182,"path":183,"stem":184},"JS reference","\u002Fapi\u002Freference","3.api\u002F2.reference",{"title":186,"path":187,"stem":188},"Rust API","\u002Fapi\u002Frust","3.api\u002F3.rust",{"title":190,"path":191,"stem":192},"Tauri commands","\u002Fapi\u002Fcommands","3.api\u002F4.commands",{"title":194,"path":195,"stem":196},"Plugin config","\u002Fapi\u002Fplugin-config","3.api\u002F5.plugin-config",{"title":198,"path":199,"stem":200},"Cargo features","\u002Fapi\u002Fcargo-features","3.api\u002F6.cargo-features",{"title":202,"path":203,"stem":204},"Environment variables","\u002Fapi\u002Fenv","3.api\u002F7.env",{"title":206,"path":207,"stem":208},"Permissions","\u002Fapi\u002Fpermissions","3.api\u002F8.permissions",{"title":210,"path":211,"stem":212},"JSON Schema","\u002Fapi\u002Fjson-schema","3.api\u002F9.json-schema",{"title":214,"path":215,"stem":216},"Showcase","\u002Fshowcase","4.showcase",{"title":218,"path":219,"stem":220,"children":221,"icon":247},"Contributing","\u002Fcontributing","5.contributing\u002F1.index",[222,223,227,231,235,239,243],{"title":218,"path":219,"stem":220},{"title":224,"path":225,"stem":226},"Development guide","\u002Fcontributing\u002Fdevelopment","5.contributing\u002F2.development",{"title":228,"path":229,"stem":230},"Render testing (config → geometry \u002F pixels)","\u002Fcontributing\u002Frender-testing","5.contributing\u002F3.render-testing",{"title":232,"path":233,"stem":234},"Visual stand (Level-2 pixels)","\u002Fcontributing\u002Fvisual-stand","5.contributing\u002F4.visual-stand",{"title":236,"path":237,"stem":238},"Linux harness (Docker)","\u002Fcontributing\u002Flinux-harness","5.contributing\u002F5.linux-harness",{"title":240,"path":241,"stem":242},"Windows surface split","\u002Fcontributing\u002Fwindows-surfaces","5.contributing\u002F6.windows-surfaces",{"title":244,"path":245,"stem":246},"Mutation testing","\u002Fcontributing\u002Fmutation-testing","5.contributing\u002F7.mutation-testing","i-lucide-git-pull-request",{"title":249,"path":250,"stem":251},"Changelog","\u002Fchangelog","6.changelog",{"id":253,"title":49,"body":254,"description":268,"extension":1391,"generated":87,"links":1392,"meta":1393,"navigation":1394,"path":50,"seo":1395,"stem":51,"__hash__":1396},"docs\u002F1.guide\u002F12.setup\u002F2.android.md",{"type":255,"value":256,"toc":1376},"minimark",[257,262,291,304,310,314,321,350,371,374,423,438,503,516,832,843,847,863,867,874,888,892,903,1085,1097,1102,1130,1134,1156,1160,1198,1202,1280,1284,1307,1311,1325,1328,1332,1366,1372],[258,259,261],"h2",{"id":260},"step-1-initialize","Step 1: Initialize",[263,264,269],"pre",{"className":265,"code":266,"language":267,"meta":268,"style":268},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm tauri android init\n","bash","",[270,271,272],"code",{"__ignoreMap":268},[273,274,277,281,285,288],"span",{"class":275,"line":276},"line",1,[273,278,280],{"class":279},"sBMFI","pnpm",[273,282,284],{"class":283},"sfazB"," tauri",[273,286,287],{"class":283}," android",[273,289,290],{"class":283}," init\n",[292,293,294,295,299,300,303],"p",{},"The plugin automatically registers its Android bridge and Glance widget receiver from the plugin AAR — you do ",[296,297,298],"strong",{},"not"," write a Glance ",[270,301,302],{},"AppWidget"," in Kotlin for the default path.",[292,305,306,309],{},[296,307,308],{},"No Kotlin code required"," — the built-in receiver reads widget config from shared storage and renders it via Jetpack Glance.",[258,311,313],{"id":312},"step-2-match-the-sharedpreferences-group","Step 2: Match the SharedPreferences group",[292,315,316,317,320],{},"The Glance receiver resolves the store name in this order (",[270,318,319],{},"WidgetStoreKeys.resolveGroup","):",[322,323,324,332,339],"ol",{},[325,326,327,328,331],"li",{},"Per-instance meta ",[270,329,330],{},"widgetId:{appWidgetId}"," binding (after pin)",[325,333,334,335,338],{},"Manifest ",[270,336,337],{},"\u003Cmeta-data android:name=\"tauri_widget_group\" …\u002F>"," on the Glance receiver",[325,340,341,342,345,346,349],{},"Fallback candidates: app ",[296,343,344],{},"package name",", ",[270,347,348],{},"group.\u003Cpackage>",", and hyphenated variants",[292,351,352,363,364,367,368,370],{},[296,353,354,355,358,359,362],{},"Your JS ",[270,356,357],{},"group"," argument to ",[270,360,361],{},"setWidgetConfig"," must be one of those names."," A random ",[270,365,366],{},"group.com.example.myapp"," from the desktop tutorial will ",[296,369,298],{}," match unless you set the same value in meta-data.",[292,372,373],{},"Simplest path — use the package name:",[263,375,379],{"className":376,"code":377,"language":378,"meta":268,"style":268},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F e.g. identifier \u002F applicationId is com.example.myapp\nawait setWidgetConfig(config, \"com.example.myapp\", widgetId);\n","typescript",[270,380,381,387],{"__ignoreMap":268},[273,382,383],{"class":275,"line":276},[273,384,386],{"class":385},"sHwdD","\u002F\u002F e.g. identifier \u002F applicationId is com.example.myapp\n",[273,388,390,394,398,402,406,409,412,415,417,420],{"class":275,"line":389},2,[273,391,393],{"class":392},"s7zQu","await",[273,395,397],{"class":396},"s2Zo4"," setWidgetConfig",[273,399,401],{"class":400},"sTEyZ","(config",[273,403,405],{"class":404},"sMK4o",",",[273,407,408],{"class":404}," \"",[273,410,411],{"class":283},"com.example.myapp",[273,413,414],{"class":404},"\"",[273,416,405],{"class":404},[273,418,419],{"class":400}," widgetId)",[273,421,422],{"class":404},";\n",[292,424,425,426,429,430,433,434,437],{},"Optional custom group — add meta-data on the ",[296,427,428],{},"merged"," application (keep the plugin’s ",[270,431,432],{},"APPWIDGET_UPDATE"," receiver intact). Prefer only injecting meta-data rather than replacing the whole ",[270,435,436],{},"\u003Creceiver>",":",[263,439,443],{"className":440,"code":441,"language":442,"meta":268,"style":268},"language-xml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003C!-- In your app AndroidManifest \u003Capplication>, after merger with the plugin: -->\n\u003Cmeta-data\n    android:name=\"tauri_widget_group\"\n    android:value=\"group.com.example.myapp\" \u002F>\n","xml",[270,444,445,450,459,482],{"__ignoreMap":268},[273,446,447],{"class":275,"line":276},[273,448,449],{"class":385},"\u003C!-- In your app AndroidManifest \u003Capplication>, after merger with the plugin: -->\n",[273,451,452,455],{"class":275,"line":389},[273,453,454],{"class":404},"\u003C",[273,456,458],{"class":457},"swJcz","meta-data\n",[273,460,462,466,468,471,474,476,479],{"class":275,"line":461},3,[273,463,465],{"class":464},"spNyl","    android",[273,467,437],{"class":404},[273,469,470],{"class":464},"name",[273,472,473],{"class":404},"=",[273,475,414],{"class":404},[273,477,478],{"class":283},"tauri_widget_group",[273,480,481],{"class":404},"\"\n",[273,483,485,487,489,492,494,496,498,500],{"class":275,"line":484},4,[273,486,465],{"class":464},[273,488,437],{"class":404},[273,490,491],{"class":464},"value",[273,493,473],{"class":404},[273,495,414],{"class":404},[273,497,366],{"class":283},[273,499,414],{"class":404},[273,501,502],{"class":404}," \u002F>\n",[292,504,505,506,508,509,512,513,437],{},"If you override the Glance ",[270,507,436],{}," yourself, keep the plugin class, provider meta-data, and intent-filter, and declare ",[270,510,511],{},"xmlns:tools"," when using ",[270,514,515],{},"tools:replace",[263,517,519],{"className":440,"code":518,"language":442,"meta":268,"style":268},"\u003Cmanifest xmlns:android=\"http:\u002F\u002Fschemas.android.com\u002Fapk\u002Fres\u002Fandroid\"\n    xmlns:tools=\"http:\u002F\u002Fschemas.android.com\u002Ftools\">\n  \u003Capplication>\n    \u003Creceiver\n        android:name=\"git.s00d.widgets.TauriGlanceWidgetReceiver\"\n        android:exported=\"true\"\n        android:label=\"My Widget\"\n        tools:replace=\"android:label\">\n      \u003Cintent-filter>\n        \u003Caction android:name=\"android.appwidget.action.APPWIDGET_UPDATE\" \u002F>\n      \u003C\u002Fintent-filter>\n      \u003Cmeta-data\n          android:name=\"android.appwidget.provider\"\n          android:resource=\"@xml\u002Ftauri_widget_info\" \u002F>\n      \u003Cmeta-data\n          android:name=\"tauri_widget_group\"\n          android:value=\"group.com.example.myapp\" \u002F>\n    \u003C\u002Freceiver>\n  \u003C\u002Fapplication>\n\u003C\u002Fmanifest>\n",[270,520,521,545,567,577,585,604,623,642,664,675,701,711,718,737,758,765,782,801,812,822],{"__ignoreMap":268},[273,522,523,525,528,531,533,536,538,540,543],{"class":275,"line":276},[273,524,454],{"class":404},[273,526,527],{"class":457},"manifest",[273,529,530],{"class":464}," xmlns",[273,532,437],{"class":404},[273,534,535],{"class":464},"android",[273,537,473],{"class":404},[273,539,414],{"class":404},[273,541,542],{"class":283},"http:\u002F\u002Fschemas.android.com\u002Fapk\u002Fres\u002Fandroid",[273,544,481],{"class":404},[273,546,547,550,552,555,557,559,562,564],{"class":275,"line":389},[273,548,549],{"class":464},"    xmlns",[273,551,437],{"class":404},[273,553,554],{"class":464},"tools",[273,556,473],{"class":404},[273,558,414],{"class":404},[273,560,561],{"class":283},"http:\u002F\u002Fschemas.android.com\u002Ftools",[273,563,414],{"class":404},[273,565,566],{"class":404},">\n",[273,568,569,572,575],{"class":275,"line":461},[273,570,571],{"class":404},"  \u003C",[273,573,574],{"class":457},"application",[273,576,566],{"class":404},[273,578,579,582],{"class":275,"line":484},[273,580,581],{"class":404},"    \u003C",[273,583,584],{"class":457},"receiver\n",[273,586,588,591,593,595,597,599,602],{"class":275,"line":587},5,[273,589,590],{"class":464},"        android",[273,592,437],{"class":404},[273,594,470],{"class":464},[273,596,473],{"class":404},[273,598,414],{"class":404},[273,600,601],{"class":283},"git.s00d.widgets.TauriGlanceWidgetReceiver",[273,603,481],{"class":404},[273,605,607,609,611,614,616,618,621],{"class":275,"line":606},6,[273,608,590],{"class":464},[273,610,437],{"class":404},[273,612,613],{"class":464},"exported",[273,615,473],{"class":404},[273,617,414],{"class":404},[273,619,620],{"class":283},"true",[273,622,481],{"class":404},[273,624,626,628,630,633,635,637,640],{"class":275,"line":625},7,[273,627,590],{"class":464},[273,629,437],{"class":404},[273,631,632],{"class":464},"label",[273,634,473],{"class":404},[273,636,414],{"class":404},[273,638,639],{"class":283},"My Widget",[273,641,481],{"class":404},[273,643,645,648,650,653,655,657,660,662],{"class":275,"line":644},8,[273,646,647],{"class":464},"        tools",[273,649,437],{"class":404},[273,651,652],{"class":464},"replace",[273,654,473],{"class":404},[273,656,414],{"class":404},[273,658,659],{"class":283},"android:label",[273,661,414],{"class":404},[273,663,566],{"class":404},[273,665,667,670,673],{"class":275,"line":666},9,[273,668,669],{"class":404},"      \u003C",[273,671,672],{"class":457},"intent-filter",[273,674,566],{"class":404},[273,676,678,681,684,686,688,690,692,694,697,699],{"class":275,"line":677},10,[273,679,680],{"class":404},"        \u003C",[273,682,683],{"class":457},"action",[273,685,287],{"class":464},[273,687,437],{"class":404},[273,689,470],{"class":464},[273,691,473],{"class":404},[273,693,414],{"class":404},[273,695,696],{"class":283},"android.appwidget.action.APPWIDGET_UPDATE",[273,698,414],{"class":404},[273,700,502],{"class":404},[273,702,704,707,709],{"class":275,"line":703},11,[273,705,706],{"class":404},"      \u003C\u002F",[273,708,672],{"class":457},[273,710,566],{"class":404},[273,712,714,716],{"class":275,"line":713},12,[273,715,669],{"class":404},[273,717,458],{"class":457},[273,719,721,724,726,728,730,732,735],{"class":275,"line":720},13,[273,722,723],{"class":464},"          android",[273,725,437],{"class":404},[273,727,470],{"class":464},[273,729,473],{"class":404},[273,731,414],{"class":404},[273,733,734],{"class":283},"android.appwidget.provider",[273,736,481],{"class":404},[273,738,740,742,744,747,749,751,754,756],{"class":275,"line":739},14,[273,741,723],{"class":464},[273,743,437],{"class":404},[273,745,746],{"class":464},"resource",[273,748,473],{"class":404},[273,750,414],{"class":404},[273,752,753],{"class":283},"@xml\u002Ftauri_widget_info",[273,755,414],{"class":404},[273,757,502],{"class":404},[273,759,761,763],{"class":275,"line":760},15,[273,762,669],{"class":404},[273,764,458],{"class":457},[273,766,768,770,772,774,776,778,780],{"class":275,"line":767},16,[273,769,723],{"class":464},[273,771,437],{"class":404},[273,773,470],{"class":464},[273,775,473],{"class":404},[273,777,414],{"class":404},[273,779,478],{"class":283},[273,781,481],{"class":404},[273,783,785,787,789,791,793,795,797,799],{"class":275,"line":784},17,[273,786,723],{"class":464},[273,788,437],{"class":404},[273,790,491],{"class":464},[273,792,473],{"class":404},[273,794,414],{"class":404},[273,796,366],{"class":283},[273,798,414],{"class":404},[273,800,502],{"class":404},[273,802,804,807,810],{"class":275,"line":803},18,[273,805,806],{"class":404},"    \u003C\u002F",[273,808,809],{"class":457},"receiver",[273,811,566],{"class":404},[273,813,815,818,820],{"class":275,"line":814},19,[273,816,817],{"class":404},"  \u003C\u002F",[273,819,574],{"class":457},[273,821,566],{"class":404},[273,823,825,828,830],{"class":275,"line":824},20,[273,826,827],{"class":404},"\u003C\u002F",[273,829,527],{"class":457},[273,831,566],{"class":404},[292,833,834,835,838,839,842],{},"Then call ",[270,836,837],{},"setWidgetConfig(..., \"group.com.example.myapp\", widgetId)"," with the ",[296,840,841],{},"same"," string.",[258,844,846],{"id":845},"step-3-run","Step 3: Run",[263,848,850],{"className":265,"code":849,"language":267,"meta":268,"style":268},"pnpm tauri android dev\n",[270,851,852],{"__ignoreMap":268},[273,853,854,856,858,860],{"class":275,"line":276},[273,855,280],{"class":279},[273,857,284],{"class":283},[273,859,287],{"class":283},[273,861,862],{"class":283}," dev\n",[258,864,866],{"id":865},"step-4-add-widget-to-home-screen","Step 4: Add widget to home screen",[292,868,869,870,873],{},"Long-press the home screen → ",[296,871,872],{},"Widgets"," → find your app → drag to screen.",[292,875,876,877,879,880,883,884,887],{},"After pinning, call ",[270,878,361],{}," for the logical ",[270,881,882],{},"widgetId"," bound to that instance (see ",[885,886,80],"a",{"href":81},").",[258,889,891],{"id":890},"what-the-plugin-adds-to-your-manifest","What the plugin adds to your manifest",[292,893,894,895,898,899,902],{},"The plugin AAR merges these entries; you do not declare them yourself. Requirements:\n",[270,896,897],{},"minSdk 23"," (Android 6.0) and ",[270,900,901],{},"compileSdk 35"," or newer in your app (Jetpack Glance 1.2).",[904,905,906,919],"table",{},[907,908,909],"thead",{},[910,911,912,916],"tr",{},[913,914,915],"th",{},"Entry",[913,917,918],{},"Purpose",[920,921,922,955,987,1004,1019,1039,1052,1067],"tbody",{},[910,923,924,933],{},[925,926,927,930,931],"td",{},[270,928,929],{},"TauriGlanceWidgetReceiver"," + ",[270,932,753],{},[925,934,935,936,938,939,942,943,946,947,950,951,954],{},"The widget. On Android 15+ the picker shows a preview generated from your stored config (refreshed after ",[270,937,361],{},"; the system rate-limits it). The info XML sets a loading layout (",[270,940,941],{},"tauri_widget_loading",", shown until the first draw), a picker preview (",[270,944,945],{},"tauri_widget_preview"," layout \u002F drawable), a description (",[270,948,949],{},"@string\u002Ftauri_widget_description",") and ",[270,952,953],{},"widgetFeatures=\"reconfigurable|configuration_optional\"",".",[910,956,957,967],{},[925,958,959,962,963,966],{},[270,960,961],{},"WidgetConfigActivity"," (",[270,964,965],{},"APPWIDGET_CONFIGURE",")",[925,968,969,970,973,974,345,977,345,980,345,983,986],{},"Configuration \u002F reconfigure screen. Lists the choices from ",[270,971,972],{},"setWidgetInstances(widgetId, [...])","; the picked id becomes that placement's instance (",[270,975,976],{},"config:{id}#{instance}",[270,978,979],{},"data:…",[270,981,982],{},"state:…",[270,984,985],{},"{{instance}}","). Without choices it closes at once, so adding a widget never stops on an empty screen.",[910,988,989,997],{},[925,990,991,962,994,966],{},[270,992,993],{},"TauriWidgetFileProvider",[270,995,996],{},"${applicationId}.tauri_widgets.files",[925,998,999,1000,1003],{},"Downloaded widget images are handed to the launcher by content URI, so large photos do not hit the RemoteViews bitmap limit. A ",[270,1001,1002],{},"\u003Cqueries>"," entry for the HOME intent lets the plugin grant the launcher read access.",[910,1005,1006,1013],{},[925,1007,1008,1009,1012],{},"WorkManager (",[270,1010,1011],{},"androidx.work",", merged by the library)",[925,1014,1015,1018],{},[270,1016,1017],{},"source"," fetches run as unique WorkManager jobs per placement (network required, exponential backoff, 3 tries), never inside a draw. The cache keeps the last good response.",[910,1020,1021,1029],{},[925,1022,1023,345,1026],{},[270,1024,1025],{},"WidgetTickReceiver",[270,1027,1028],{},"ActivityActionReceiver",[925,1030,1031,1032,1035,1036,1038],{},"Scheduled redraws (",[270,1033,1034],{},"entries",", due ",[270,1037,1017],{},") and live-activity buttons.",[910,1040,1041,1049],{},[925,1042,1043,345,1046],{},[270,1044,1045],{},"POST_NOTIFICATIONS",[270,1047,1048],{},"POST_PROMOTED_NOTIFICATIONS",[925,1050,1051],{},"Live activities; Android 16 Live Updates.",[910,1053,1054,1060],{},[925,1055,1056,1059],{},[270,1057,1058],{},"com.samsung.android.support.ongoing_activity"," (application meta-data)",[925,1061,1062,1063,887],{},"Samsung One UI 7 Live Notifications \u002F Now Bar for the activity notification (see ",[885,1064,1066],{"href":1065},"#samsung-now-bar-cover-screen","Samsung",[910,1068,1069,1082],{},[925,1070,1071,1074,1075,1078,1079],{},[270,1072,1073],{},"com.samsung.android.appwidget.provider"," → ",[270,1076,1077],{},"@xml\u002Ftauri_widget_samsung"," on the receiver, ",[270,1080,1081],{},"widgetCategory=\"home_screen|keyguard\"",[925,1083,1084],{},"Galaxy Z Flip cover screen (Flex Window) and lock-screen hosts.",[292,1086,1087,1088,1090,1091,1093,1094,954],{},"Override any of the strings, the ",[270,1089,945],{}," drawable or the layouts by defining a\nresource with the same name in your app. To drop the configuration screen, override\n",[270,1092,753],{}," without ",[270,1095,1096],{},"android:configure",[1098,1099,1101],"h3",{"id":1100},"local-state-on-the-widget","Local state on the widget",[292,1103,1104,1105,1108,1109,1112,1113,1116,1117,1119,1120,1123,1124,1126,1127,1129],{},"Buttons, toggles and links with ",[270,1106,1107],{},"set"," change the placement's ",[270,1110,1111],{},"state"," in the widget process\n(no app launch): the tap writes ",[270,1114,1115],{},"state:{widgetId}#{appWidgetId}"," (or the configured\ninstance), redraws that placement, then still queues ",[270,1118,683],{}," for the app. A running app\nalso gets ",[270,1121,1122],{},"widget-state-changed",". See the ",[270,1125,1111],{}," \u002F ",[270,1128,1107],{}," fields in the element reference.",[1098,1131,1133],{"id":1132},"live-updates-android-16","Live Updates (Android 16)",[292,1135,1136,1137,345,1140,1143,1144,1147,1148,1151,1152,1155],{},"Live activities ask for promotion (",[270,1138,1139],{},"setRequestPromotedOngoing",[270,1141,1142],{},"setShortCriticalText",",\n",[270,1145,1146],{},"ProgressStyle"," on API 36). The user decides in system settings. The Android bridge has\n",[270,1149,1150],{},"canPostPromotedNotifications"," (is promotion allowed now) and ",[270,1153,1154],{},"openPromotionSettings"," (opens\nthat settings page; the app's notification settings before Android 16).",[1098,1157,1159],{"id":1158},"lock-screen-and-out-of-order-updates","Lock screen and out-of-order updates",[1161,1162,1163,1184],"ul",{},[325,1164,1165,1168,1169,1126,1172,1175,1176,1179,1180,1183],{},[270,1166,1167],{},"visibility: \"private\""," posts a redacted public version for the secure lock screen:\napp name, timer (",[270,1170,1171],{},"endsAt",[270,1173,1174],{},"startedAt","), progress and tint; no title, body or buttons.\n",[270,1177,1178],{},"\"secret\""," hides the notification there; ",[270,1181,1182],{},"\"public\""," (default) shows it in full.",[325,1185,1186,1189,1190,1193,1194,1197],{},[270,1187,1188],{},"timestamp"," (Unix ms): an update older than the last applied one for that id is dropped\nand the bridge answers ",[270,1191,1192],{},"applied: false",", as on iOS. A new start always applies;\n",[270,1195,1196],{},"endActivity"," forgets the last timestamp.",[1098,1199,1201],{"id":1200},"samsung-now-bar-cover-screen","Samsung: Now Bar, cover screen",[1161,1203,1204,1245],{},[325,1205,1206,1209,1210,1213,1214,1217,1218,1221,1222,1225,1226,1228,1229,1232,1233,1236,1237,1240,1241,1244],{},[296,1207,1208],{},"Now Bar \u002F Live Notifications."," On Samsung phones below Android 16 (One UI 7) the\nactivity notification also carries Samsung's ",[270,1211,1212],{},"android.ongoingActivityNoti.*"," extras:\n",[270,1215,1216],{},"title"," → primary line, ",[270,1219,1220],{},"body"," → secondary line, ",[270,1223,1224],{},"shortCriticalText"," (else ",[270,1227,1216],{},") →\nstatus-bar chip, ",[270,1230,1231],{},"tint"," → chip and progress color, ",[270,1234,1235],{},"progress",", actions. Samsung shows them\nonly for media apps and allow-listed packages. On One UI 8+ (Android 16) the Now Bar takes\nthe standard Live Update instead, so no Samsung extras are added there (they would cancel\nthe promotion). The user still enables the app in the Now Bar \u002F Live notifications\nsettings. ",[270,1238,1239],{},"private"," shows the app name in the Now Bar; ",[270,1242,1243],{},"secret"," adds nothing.",[325,1246,1247,1250,1251,1254,1255,1258,1259,1262,1263,1266,1267,1126,1270,1273,1274,1276,1277,954],{},[296,1248,1249],{},"Cover screen (Galaxy Z Flip Flex Window)."," The receiver declares\n",[270,1252,1253],{},"\u003Csamsung-appwidget-provider display=\"sub_screen\">"," and ",[270,1256,1257],{},"keyguard",". The user adds the\nwidget under ",[296,1260,1261],{},"Settings > Cover screen > Widgets",". On a lock-screen host (cover screen,\nAndroid 16 lock-screen hub) the widget draws its ",[270,1264,1265],{},"small"," layout. You add nothing to the\napp manifest. Samsung recommends ",[270,1268,1269],{},"minWidth 352dp",[270,1271,1272],{},"minHeight 339dp"," for the cover\nscreen. If your device does not list the widget with the plugin's 110 dp minimum, override\n",[270,1275,753],{}," with those sizes. To keep the widget off lock screens, override\nit with ",[270,1278,1279],{},"widgetCategory=\"home_screen\"",[1098,1281,1283],{"id":1282},"long-lists","Long lists",[292,1285,1286,1287,1290,1291,1294,1295,1298,1299,1302,1303,1306],{},"A ",[270,1288,1289],{},"list"," with ",[270,1292,1293],{},"items"," scrolls (Glance ",[270,1296,1297],{},"LazyColumn",", a launcher ",[270,1300,1301],{},"ListView",") once its rows are\ntaller than the widget. Shorter lists draw as before. At most 50 rows are sent; the rest\nshow as \"+N more\". Lists with custom ",[270,1304,1305],{},"children"," do not scroll.",[258,1308,1310],{"id":1309},"custom-widget-provider-advanced","Custom Widget Provider (advanced)",[292,1312,1313,1314,1126,1317,1320,1321,1324],{},"If you need custom behavior, create your own ",[270,1315,1316],{},"GlanceAppWidget",[270,1318,1319],{},"GlanceAppWidgetReceiver"," and keep the same shared-group + ",[270,1322,1323],{},"config:{widgetId}"," contract.",[1326,1327],"hr",{},[258,1329,1331],{"id":1330},"when-it-fails","When it fails",[1161,1333,1334,1340,1347,1350,1353],{},[325,1335,1336,1337,1339],{},"Empty tile: JS ",[270,1338,357],{}," ≠ what Glance resolves (log package name \u002F meta-data).",[325,1341,1342,1343,1346],{},"Check ",[270,1344,1345],{},"adb logcat | grep -i widget"," for errors.",[325,1348,1349],{},"Canvas bitmaps larger than 512px are automatically capped.",[325,1351,1352],{},"Bitmap data is compressed to stay under the Binder IPC 500KB limit.",[325,1354,1355,1356,1126,1359,1362,1363,954],{},"Prefer flat ",[270,1357,1358],{},"vstack",[270,1360,1361],{},"hstack","; always set ",[270,1364,1365],{},"progress.label",[292,1367,1368,1369,954],{},"More symptoms: ",[885,1370,1371],{"href":40},"Troubleshooting index",[1373,1374,1375],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":268,"searchDepth":389,"depth":461,"links":1377},[1378,1379,1380,1381,1382,1389,1390],{"id":260,"depth":389,"text":261},{"id":312,"depth":389,"text":313},{"id":845,"depth":389,"text":846},{"id":865,"depth":389,"text":866},{"id":890,"depth":389,"text":891,"children":1383},[1384,1385,1386,1387,1388],{"id":1100,"depth":461,"text":1101},{"id":1132,"depth":461,"text":1133},{"id":1158,"depth":461,"text":1159},{"id":1200,"depth":461,"text":1201},{"id":1282,"depth":461,"text":1283},{"id":1309,"depth":389,"text":1310},{"id":1330,"depth":389,"text":1331},"md",null,{},true,{"title":49,"description":268},"j2fbPyo0c7a8DmW-0AaDObxAJQaR3h7a9k_sSWuSJW4",[1398,1400],{"title":43,"path":44,"stem":45,"description":1399,"children":-1},"Pick a surface. Desktop is the fastest feedback loop; native extensions take longer but ship on the home screen.",{"title":53,"path":54,"stem":55,"description":268,"children":-1},1794660592275]