[{"data":1,"prerenderedAt":1111},["ShallowReactive",2],{"navigation":3,"\u002Fguide\u002Fsetup\u002Fmacos":252,"\u002Fguide\u002Fsetup\u002Fmacos-surround":1107},[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":57,"body":254,"description":1101,"extension":1102,"generated":87,"links":1103,"meta":1104,"navigation":674,"path":58,"seo":1105,"stem":59,"__hash__":1106},"docs\u002F1.guide\u002F12.setup\u002F4.macos.md",{"type":255,"value":256,"toc":1089},"minimark",[257,285,311,325,330,355,378,385,422,429,598,605,609,620,638,642,650,654,705,708,727,741,745,753,771,805,881,899,903,932,935,938,942,947,1035,1039,1076,1085],[258,259,260,261,265,266,269,270,276,277,280,281,284],"p",{},"macOS widgets require a \"sidecar\" Xcode project — a small project alongside your Tauri app that compiles the Widget Extension (",[262,263,264],"code",{},".appex","). After ",[262,267,268],{},"init-macos",", a normal ",[271,272,273],"strong",{},[262,274,275],{},"pnpm tauri build"," produces an ",[262,278,279],{},".app"," (and DMG) with ",[262,282,283],{},"Contents\u002FPlugIns\u002F*.appex"," already inside.",[286,287,288],"blockquote",{},[258,289,290,293,294,297,298,301,302,304,305,310],{},[271,291,292],{},"Important:"," On macOS, WidgetKit picks up extension widgets from the installed app bundle.",[295,296],"br",{},"\nAddable widgets appear only after you ",[271,299,300],{},"build"," the app and move the resulting ",[262,303,279],{}," to ",[271,306,307],{},[262,308,309],{},"\u002FApplications"," (or install from the DMG).",[258,312,313,316,317,320,321,324],{},[271,314,315],{},"Requirements:"," ",[262,318,319],{},"xcodegen"," (",[262,322,323],{},"brew install xcodegen",")",[326,327,329],"h2",{"id":328},"step-1-initialize-the-widget-project","Step 1: Initialize the widget project",[331,332,337],"pre",{"className":333,"code":334,"language":335,"meta":336,"style":336},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx tauri-widgets init-macos\n","bash","",[262,338,339],{"__ignoreMap":336},[340,341,344,348,352],"span",{"class":342,"line":343},"line",1,[340,345,347],{"class":346},"sBMFI","npx",[340,349,351],{"class":350},"sfazB"," tauri-widgets",[340,353,354],{"class":350}," init-macos\n",[258,356,357,358,361,362,365,366,369,370,373,374,377],{},"Bundle id (",[262,359,360],{},"\u003Cidentifier>.widgetkit",") and App Group (",[262,363,364],{},"group.\u003Cidentifier>",") come from ",[262,367,368],{},"tauri.conf.json","; pass ",[262,371,372],{},"--bundle-id"," \u002F ",[262,375,376],{},"--app-group"," to override.",[258,379,380,381,384],{},"This creates ",[262,382,383],{},"src-tauri\u002Fmacos-widget\u002F",":",[386,387,388,401,409],"ul",{},[389,390,391,394,395,320,398,324],"li",{},[262,392,393],{},"Sources\u002FMyWidget.swift"," — widget code using ",[262,396,397],{},"TauriWidgetProvider",[262,399,400],{},"widgetId: \"default\"",[389,402,403,406,407],{},[262,404,405],{},"project.yml"," — XcodeGen spec for the ",[262,408,264],{},[389,410,411,414,415,417,418,421],{},[262,412,413],{},"build-widget.sh"," — builds and signs the ",[262,416,264],{},"; regenerates both ",[262,419,420],{},".entitlements"," from the App Group on every build",[258,423,424,425,428],{},"and writes ",[262,426,427],{},"src-tauri\u002Ftauri.macos.conf.json"," (Tauri merges it on macOS only, so Linux \u002F Windows builds are untouched):",[331,430,434],{"className":431,"code":432,"language":433,"meta":336,"style":336},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"build\": {\n    \"beforeBundleCommand\": \".\u002Fsrc-tauri\u002Fmacos-widget\u002Fbuild-widget.sh\"\n  },\n  \"bundle\": {\n    \"macOS\": {\n      \"entitlements\": \".\u002Fmacos-widget\u002FApp.entitlements\",\n      \"files\": {\n        \"PlugIns\u002FTauriWidgetExtension.appex\": \".\u002Fmacos-widget\u002Fbuild\u002FBuild\u002FProducts\u002FRelease\u002FTauriWidgetExtension.appex\"\n      }\n    }\n  }\n}\n","json",[262,435,436,442,459,481,487,501,515,539,553,574,580,586,592],{"__ignoreMap":336},[340,437,438],{"class":342,"line":343},[340,439,441],{"class":440},"sMK4o","{\n",[340,443,445,448,451,454,456],{"class":342,"line":444},2,[340,446,447],{"class":440},"  \"",[340,449,300],{"class":450},"spNyl",[340,452,453],{"class":440},"\"",[340,455,384],{"class":440},[340,457,458],{"class":440}," {\n",[340,460,462,465,468,470,472,475,478],{"class":342,"line":461},3,[340,463,464],{"class":440},"    \"",[340,466,467],{"class":346},"beforeBundleCommand",[340,469,453],{"class":440},[340,471,384],{"class":440},[340,473,474],{"class":440}," \"",[340,476,477],{"class":350},".\u002Fsrc-tauri\u002Fmacos-widget\u002Fbuild-widget.sh",[340,479,480],{"class":440},"\"\n",[340,482,484],{"class":342,"line":483},4,[340,485,486],{"class":440},"  },\n",[340,488,490,492,495,497,499],{"class":342,"line":489},5,[340,491,447],{"class":440},[340,493,494],{"class":450},"bundle",[340,496,453],{"class":440},[340,498,384],{"class":440},[340,500,458],{"class":440},[340,502,504,506,509,511,513],{"class":342,"line":503},6,[340,505,464],{"class":440},[340,507,508],{"class":346},"macOS",[340,510,453],{"class":440},[340,512,384],{"class":440},[340,514,458],{"class":440},[340,516,518,521,525,527,529,531,534,536],{"class":342,"line":517},7,[340,519,520],{"class":440},"      \"",[340,522,524],{"class":523},"sbssI","entitlements",[340,526,453],{"class":440},[340,528,384],{"class":440},[340,530,474],{"class":440},[340,532,533],{"class":350},".\u002Fmacos-widget\u002FApp.entitlements",[340,535,453],{"class":440},[340,537,538],{"class":440},",\n",[340,540,542,544,547,549,551],{"class":342,"line":541},8,[340,543,520],{"class":440},[340,545,546],{"class":523},"files",[340,548,453],{"class":440},[340,550,384],{"class":440},[340,552,458],{"class":440},[340,554,556,559,563,565,567,569,572],{"class":342,"line":555},9,[340,557,558],{"class":440},"        \"",[340,560,562],{"class":561},"swJcz","PlugIns\u002FTauriWidgetExtension.appex",[340,564,453],{"class":440},[340,566,384],{"class":440},[340,568,474],{"class":440},[340,570,571],{"class":350},".\u002Fmacos-widget\u002Fbuild\u002FBuild\u002FProducts\u002FRelease\u002FTauriWidgetExtension.appex",[340,573,480],{"class":440},[340,575,577],{"class":342,"line":576},10,[340,578,579],{"class":440},"      }\n",[340,581,583],{"class":342,"line":582},11,[340,584,585],{"class":440},"    }\n",[340,587,589],{"class":342,"line":588},12,[340,590,591],{"class":440},"  }\n",[340,593,595],{"class":342,"line":594},13,[340,596,597],{"class":440},"}\n",[258,599,600,601,604],{},"No ",[262,602,603],{},"plugins.widgets"," block is needed.",[326,606,608],{"id":607},"step-2-transport-usually-nothing-to-do","Step 2: Transport (usually nothing to do)",[258,610,611,612,615,616,619],{},"On macOS the host writes widget data straight into the extension's own container (",[262,613,614],{},"transport: \"widgetContainer\"",", the default). This works with ad-hoc and Developer ID signing, as long as the host app is ",[271,617,618],{},"not sandboxed"," (the Tauri default).",[258,621,622,625,626,629,630,633,634,637],{},[262,623,624],{},"group.*"," App Group containers need a provisioning profile on macOS: without one, the sandboxed extension cannot open them and shows ",[271,627,628],{},"No configuration",". Set ",[262,631,632],{},"\"transport\": \"appGroup\""," only for a sandboxed Mac App Store build. Details: ",[635,636,23],"a",{"href":24},".",[326,639,641],{"id":640},"step-3-install","Step 3: Install",[258,643,644,645,304,647,649],{},"WidgetKit lists widgets only from an installed app: build, then move the ",[262,646,279],{},[262,648,309],{}," (or install the DMG) and launch it once.",[326,651,653],{"id":652},"step-4-build","Step 4: Build",[331,655,657],{"className":333,"code":656,"language":335,"meta":336,"style":336},"pnpm tauri build\n\n# Prefer the identity printed by `npx tauri-widgets signing`:\nWIDGET_SIGN_IDENTITY=\"Apple Development: you@example.com (TEAMID)\" pnpm tauri build\n",[262,658,659,670,676,682],{"__ignoreMap":336},[340,660,661,664,667],{"class":342,"line":343},[340,662,663],{"class":346},"pnpm",[340,665,666],{"class":350}," tauri",[340,668,669],{"class":350}," build\n",[340,671,672],{"class":342,"line":444},[340,673,675],{"emptyLinePlaceholder":674},true,"\n",[340,677,678],{"class":342,"line":461},[340,679,681],{"class":680},"sHwdD","# Prefer the identity printed by `npx tauri-widgets signing`:\n",[340,683,684,688,691,693,696,698,701,703],{"class":342,"line":483},[340,685,687],{"class":686},"sTEyZ","WIDGET_SIGN_IDENTITY",[340,689,690],{"class":440},"=",[340,692,453],{"class":440},[340,694,695],{"class":350},"Apple Development: you@example.com (TEAMID)",[340,697,453],{"class":440},[340,699,700],{"class":346}," pnpm",[340,702,666],{"class":350},[340,704,669],{"class":350},[258,706,707],{},"Pipeline:",[709,710,711,714,721],"ol",{},[389,712,713],{},"Rust + frontend build",[389,715,716,718,719],{},[262,717,413],{}," → signed ",[262,720,264],{},[389,722,723,724,726],{},"Tauri copies PlugIns, nested-codesigns, notarizes (if configured), writes ",[262,725,279],{}," \u002F DMG",[286,728,729],{},[258,730,731,316,734,737,738,637],{},[271,732,733],{},"Tip:",[262,735,736],{},"{ \"scripts\": { \"build:macos\": \"tauri build\" } }"," then ",[262,739,740],{},"pnpm build:macos",[326,742,744],{"id":743},"code-signing","Code Signing",[258,746,747,749,750,752],{},[262,748,413],{}," signs the ",[262,751,264],{}," before bundling. Identity resolution:",[709,754,755,759,764],{},[389,756,757],{},[262,758,687],{},[389,760,761],{},[262,762,763],{},"APPLE_SIGNING_IDENTITY",[389,765,766,767,770],{},"Fallback: ",[262,768,769],{},"-"," (ad-hoc)",[331,772,774],{"className":333,"code":773,"language":335,"meta":336,"style":336},"npx tauri-widgets signing          # lists identities\nsecurity find-identity -v -p codesigning\n",[262,775,776,788],{"__ignoreMap":336},[340,777,778,780,782,785],{"class":342,"line":343},[340,779,347],{"class":346},[340,781,351],{"class":350},[340,783,784],{"class":350}," signing",[340,786,787],{"class":680},"          # lists identities\n",[340,789,790,793,796,799,802],{"class":342,"line":444},[340,791,792],{"class":346},"security",[340,794,795],{"class":350}," find-identity",[340,797,798],{"class":350}," -v",[340,800,801],{"class":350}," -p",[340,803,804],{"class":350}," codesigning\n",[806,807,808,829],"table",{},[809,810,811],"thead",{},[812,813,814,818,821,826],"tr",{},[815,816,817],"th",{},"Signing",[815,819,820],{},"Widget visible",[815,822,823],{},[262,824,825],{},"transport",[815,827,828],{},"Distribution",[830,831,832,852,866],"tbody",{},[812,833,834,840,843,849],{},[835,836,837,838,324],"td",{},"Ad-hoc (",[262,839,769],{},[835,841,842],{},"Yes",[835,844,845,848],{},[262,846,847],{},"widgetContainer"," (default)",[835,850,851],{},"Local only",[812,853,854,857,859,863],{},[835,855,856],{},"Developer ID (+ notarization)",[835,858,842],{},[835,860,861,848],{},[262,862,847],{},[835,864,865],{},"Direct distribution",[812,867,868,871,873,878],{},[835,869,870],{},"Mac App Store (sandboxed host)",[835,872,842],{},[835,874,875],{},[262,876,877],{},"appGroup",[835,879,880],{},"App Store",[258,882,883,884,887,888,891,892,895,896,898],{},"The main app's ",[262,885,886],{},"App.entitlements"," must ",[271,889,890],{},"not"," include ",[262,893,894],{},"com.apple.security.app-sandbox"," with ",[262,897,847],{},". The widget extension is always sandboxed (WidgetKit requires it).",[326,900,902],{"id":901},"debugging-the-widget-separately","Debugging the widget separately",[331,904,906],{"className":333,"code":905,"language":335,"meta":336,"style":336},"cd src-tauri\u002Fmacos-widget\nxcodegen generate\nopen TauriWidgetExtension.xcodeproj\n",[262,907,908,917,924],{"__ignoreMap":336},[340,909,910,914],{"class":342,"line":343},[340,911,913],{"class":912},"s2Zo4","cd",[340,915,916],{"class":350}," src-tauri\u002Fmacos-widget\n",[340,918,919,921],{"class":342,"line":444},[340,920,319],{"class":346},[340,922,923],{"class":350}," generate\n",[340,925,926,929],{"class":342,"line":461},[340,927,928],{"class":346},"open",[340,930,931],{"class":350}," TauriWidgetExtension.xcodeproj\n",[258,933,934],{},"Select the widget scheme in Xcode, set your app as the Host Application, and run with breakpoints.",[936,937],"hr",{},[326,939,941],{"id":940},"when-it-fails","When it fails",[943,944,946],"h3",{"id":945},"widget-shows-no-configuration","Widget shows \"No configuration\"",[386,948,949,959,968,978,1009,1015,1025],{},[389,950,951,952,955,956,958],{},"Call ",[262,953,954],{},"setWidgetConfig(...)"," from your app (with the app launched from ",[262,957,309],{},").",[389,960,961,964,965,967],{},[262,962,963],{},"transport: \"appGroup\""," in a Developer ID \u002F ad-hoc build: remove it (the extension cannot open a ",[262,966,624],{}," container without a provisioning profile).",[389,969,970,971,320,973,975,976,958],{},"Check that the app is ",[271,972,618],{},[262,974,886],{}," should not contain ",[262,977,894],{},[389,979,980,981],{},"Verify the widget's container has the data file:\n",[331,982,984],{"className":333,"code":983,"language":335,"meta":336,"style":336},"ls ~\u002FLibrary\u002FContainers\u002F\u003Cyour-bundle-id>.widgetkit\u002FData\u002Fwidget_data.json\n",[262,985,986],{"__ignoreMap":336},[340,987,988,991,994,997,1000,1003,1006],{"class":342,"line":343},[340,989,990],{"class":346},"ls",[340,992,993],{"class":350}," ~\u002FLibrary\u002FContainers\u002F",[340,995,996],{"class":440},"\u003C",[340,998,999],{"class":350},"your-bundle-i",[340,1001,1002],{"class":686},"d",[340,1004,1005],{"class":440},">",[340,1007,1008],{"class":350},".widgetkit\u002FData\u002Fwidget_data.json\n",[389,1010,1011,1012],{},"Check widget logs: ",[262,1013,1014],{},"log show --last 1m --predicate 'subsystem == \"com.tauri.widgets\"' --style compact",[389,1016,1017,1018,1021,1022,1024],{},"Ensure ",[262,1019,1020],{},"TauriWidgetExtension.entitlements"," contains ",[262,1023,894],{}," and the correct App Group.",[389,1026,1027,1028,1031,1032,958],{},"Align Swift ",[262,1029,1030],{},"widgetId"," with JS (default ",[262,1033,1034],{},"\"default\"",[943,1036,1038],{"id":1037},"widget-doesnt-update","Widget doesn't update",[386,1040,1041,1044,1069],{},[389,1042,1043],{},"Apple limits widget refreshes to ~40–70 per day.",[389,1045,1046,1047,320,1050,1053,1054,1057,1058,1061,1062,1065,1066,637],{},"Check plugin throttle on ",[271,1048,1049],{},"iOS",[262,1051,1052],{},"TAURI_WIDGET_MIN_RELOAD_SECS","; Debug ",[262,1055,1056],{},"0",", Release ",[262,1059,1060],{},"900","). On the macOS app host this env is unused — inspect ",[262,1063,1064],{},"ApplyOutcome.reload"," from ",[262,1067,1068],{},"setWidgetConfig",[389,1070,1071,1072,1075],{},"Prefer ",[262,1073,1074],{},"{ type: \"timer\" }"," for live UI.",[258,1077,1078,1079,1082,1083,637],{},"More symptoms: ",[635,1080,1081],{"href":40},"Troubleshooting index",". Transport: ",[635,1084,23],{"href":24},[1086,1087,1088],"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 .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}",{"title":336,"searchDepth":444,"depth":461,"links":1090},[1091,1092,1093,1094,1095,1096,1097],{"id":328,"depth":444,"text":329},{"id":607,"depth":444,"text":608},{"id":640,"depth":444,"text":641},{"id":652,"depth":444,"text":653},{"id":743,"depth":444,"text":744},{"id":901,"depth":444,"text":902},{"id":940,"depth":444,"text":941,"children":1098},[1099,1100],{"id":945,"depth":461,"text":946},{"id":1037,"depth":461,"text":1038},"macOS widgets require a \"sidecar\" Xcode project — a small project alongside your Tauri app that compiles the Widget Extension (.appex). After init-macos, a normal pnpm tauri build produces an .app (and DMG) with Contents\u002FPlugIns\u002F*.appex already inside.","md",null,{},{"title":57,"description":1101},"ChQewZzZBznu2rQBOKokKkUbb69Z6rIc9TXFBtmWemo",[1108,1109],{"title":53,"path":54,"stem":55,"description":336,"children":-1},{"title":61,"path":62,"stem":63,"description":1110,"children":-1},"Two surfaces: Widgets Board (Adaptive Cards + MSIX provider) and\u002For the same desktop webview as other OSes.",1794660592405]