wehub-resource-sync
1.3 KiB
1.3 KiB
Navigation Runtime State
Runtime navigation uses React Router MemoryRouter plus MobileGym's app navigation hooks.
App Contract
Business pages should use the app's go() / back() helpers, not useNavigate() directly.
The entry component calls useAppNavigationHandler inside MemoryRouter. The hook registers:
| Registration | Purpose |
|---|---|
| App navigator | Lets OS route openApp(id, route). |
| Activity navigator | Lets OS control borrowed/foreign Activity instances. |
| Back handler | Connects app history to BackDispatcher. |
| History tracker | Maintains shadow entries for popTo and generated path logic. |
URL as UI State
Dialogs, drawers, tabs, filters, and finite UI states should be represented in route/search state so Back can close them correctly.
React local state is fine for visual-only details that Back does not need to understand.
Foreign Task Isolation
When app B is pushed onto app A's Task, app B may already have a background own-Task instance. The foreign instance skips app-level registration and uses only Activity-level navigation to avoid clobbering the background instance.
Related Docs
- Declaration grammar → declaration.md
- OS Task lifecycle → ../os/task-lifecycle.md
- Cross-app launch → ../os/cross-app-launch.md