harmonyos

Group diagnostics by arkts-* rule id rather than by file, then fix one category at a time: typing first, then object shape, statements, and functions. Confirm standard mode is active via compatibleSdkVersion >= 10 in build-profile.json5 before rewriting, and rebuild after each category.

Default to TaskPool; its tasks are capped at three minutes of execution excluding awaited I/O. Choose Worker only for longer work, noting Workers cannot be cancelled, at most 64 run per process, and priority configuration requires API 18.

V2 uses @ObservedV2 classes with @Trace per property plus @Param/@Event in @ComponentV2, while V1 uses @State/@Prop/@Link and @Observed/@ObjectLink for nested observation. Mixing decorators within one component is a compile error, and cross-generation data passing needs UIUtils interop APIs from API 19.

Stale UI usually means a missing @Trace on an @ObservedV2 property, V1 @State expecting nested observation it cannot provide, or data crossing a V1/V2 boundary without enableV2Compatibility. Check which generation each component belongs to and whether the observed property is actually traced.

Global router functions are deprecated since API 18 with @useinstead pointing to UIContext.getRouter(), available since API 10. New code should use Navigation with NavPathStack and NavDestination; router params also cannot carry functions.

A user_grant permission requires a localized reason string and usedScene with when set to inuse or always in module.json5, enforced at AppGallery release verification. After user refusal, requestPermissionsFromUser shows no dialog, so the app must direct users to Settings and re-check with checkAccessToken before each protected call.