dengshiyinga/harmonyos-ai-skill/harmonyos-development

HarmonyOS (鸿蒙) Development

Covers HarmonyOS 7 / API 26.0.0 Release and existing HarmonyOS 6.1 / 6.1.1 (API 23 / 24) native apps. Primary language is ArkTS and the primary UI framework is ArkUI. For new projects use the API 26 Release toolchain; for existing projects inspect SDK settings before changing them. Set compatibleSdkVersion from device coverage and protect newer calls on older devices.

Read references/platform-baseline.md for SDK selection, references/api26-release.md for migration, and references/ndk-napi.md for C/C++ bindings, threads, async work, and ownership. Other task-specific references are routed through references/README.md.

Platform snapshot

Release timeline (recent):

• HarmonyOS 6.0.1(21) — 2025/11/25 (initial stable with Mate 80 series)
• HarmonyOS 6.0.2(22) — 2026/01/23 (incremental update)
• HarmonyOS 6.0.0.328 Pollen Beta(23) — 2026/02/28 (closed beta, 25 models)
• HarmonyOS 6.1(23) — 2026/04/20 (stable general release)
• HarmonyOS 6.1.1(24) Beta 1 — 2026/04/30 (developer beta)
• HarmonyOS 6.1.1(24) Release — 2026/05/26 (API 24 Release; DevEco Studio 6.1.1.280)
• HarmonyOS 7 / 26.0.0 Beta1 — 2026/06/12 (API 26 developer preview; DevEco Studio 26.0.0.461)
• HarmonyOS 7 / 26.0.0 Release — 2026/08 (official August bulletin; supersedes Beta1/Beta2)

What's new in API 23 (HarmonyOS 6.1)

ArkUI enhancements:

• Navigation supports binding the routing stack to the component itself and specifying a NavDestination as the navigation bar (home page) — no more separate root container needed
• Menu adds anchorPosition property: control popup position relative to upper-left of anchor with horizontal/vertical offsets
• Image component improved SVG parsing capabilities
• Batch of new C APIs for attribute styles (Native side)

New C-side capabilities (Native/NAPI):

• UDMF (Unified Data Management Framework) C APIs
• Component drag-and-drop C APIs
• Cryptographic algorithm C APIs

Data:

• relationalStore enhanced sendable function — better cross-thread data passing

Graphics & AI:

• AI super frame feature in Graphics Accelerate Kit (frame interpolation for smoother animations)

ArkWeb: further capability enhancements (intercept/cookies)

What's new in API 24 (HarmonyOS 6.1.1 Release)

Version baseline: API 24 is now a Release SDK (not only Beta). Use DevEco Studio 6.1.1 Release (6.1.1.280), HarmonyOS SDK 6.1.1 Release, Hvigor 6.24.2, ohpm 6.1.2.268, and Node.js 18.20.1 for API 24 projects.

Release additions over Beta1:

• Ability Kit — AbilityStage adds callbacks before the first Ability is created and when a process starts from an application snapshot.
• ArkTS — adds enableLocalHandleDetection to keep EventHandler/libuv tasks inside the intended scope and avoid leaks; XML parsing adds XmlSAXHandler callbacks for SAX-style parsing.
• ArkWeb — download completion callbacks can retrieve the original URL and referrer URL.
• Call Service Kit — enterprise call service lookup for incoming/outgoing phone numbers.
• Camera Kit professional controls — flash-state event subscribe/unsubscribe; OIS query/set; lens focal length/equivalent focal length/min focus distance/distortion/intrinsic calibration/sensor size/pixel array/color-filter data; logical camera composition; auto/manual exposure; manual focus; ISO; physical aperture.
• CANN Kit — large-language-model inference acceleration APIs on PC devices.
• MDM Kit — manage hidden settings entries for the current user.

Beta1 additions still relevant in API 24 Release:

• Camera Kit "Follow the Person" — automatic camera tracking API that keeps a person centered in frame via real-time crop/zoom. Useful for video calls, workout recording, vlogging:

``ts // Conceptual API — full signature in official docs cameraSession.enableSubjectTracking(camera.TrackingMode.PERSON); ``

• Delayed preview output — add delayed preview directly to the stream pipeline instead of normal preview output, and configure its Surface separately.
• ArkTS VM diagnostics — heap information per VM thread, heap-warning callbacks after GC, and taskpool.execute() timeout settings.
• ArkUI — parallel-window state query, custom component migration across Ability instances, dynamic layout container, root node lookup for UIContext, async drag-drop decisions, onNeedSoftkeyboard, Canvas/OffscreenCanvas antialias, Tabs nested scrolling, multiline ellipsis modes (MULTILINE_START, MULTILINE_CENTER).
• ArkWeb — User-Agent Client Hints, default context-menu switch, URL whitelist and load/jump security controls.
• Audio Kit — independent audio session strategy/behavior for capture/rendering, plus OH_MIDI C APIs for USB/BLE MIDI devices.
• New/expanded Kits — Content Embed Kit, Enterprise Threat Protection Kit, FAST Kit, NearLink Kit, Network Boost Kit, Screen Time Guard Kit, Device Security Kit, Desktop Extension Kit.
• DevEco Studio — API 24 projects, Hot Reload for C++ and resource edits, expanded AppFreeze parsing, ComMemory UI memory analysis, strictCheckerOnly for faster strict syntax checks.

HarmonyOS 7 / API 26 Release (verified 2026/10/24)

Status: API 26.0.0 Release supports production development. Beta1 and Beta2 describe historical snapshots. Preserve existing API 24 project settings unless upgrading; distinguish compile SDK, target SDK behavior, and minimum-compatible device API.

Verified Release pairing: HarmonyOS SDK 26.0.0 Release, DevEco Studio / Command Line Tools 26.0.0.821, HarmonyOS Emulator 26.0.0.400, Hvigor/hvigorw 6.26.4, ohpm 26.0.0.630, Node.js 24.14.1, hstack 6.1.0. compileSdkVersion: "26.0.0"; set target explicitly and choose minimum compatibility from device coverage. These are matched Release versions, not a guarantee of the latest IDE patch.

Version-number rule: Starting with API 26.0.0, HarmonyOS developer kit API versions use SemVer (X.Y.Z) instead of the legacy X.Y.Z(N) format. X means a major version with substantial capabilities or adaptation-impacting changes, Y means a minor version with new capabilities, and Z means compatible fixes/small improvements.

API 26 capability overview (introduced during Beta; verify final signatures in the Release SDK):

• Ability Kit — AgentCard support; ArkTS script-based app Skill development; package-name + clone-index app name lookup; ArkTS APIs for script management; C APIs for ModularObjectExtensionAbility.
• Accessibility Kit — system care mode integration for elder-friendly app experiences.
• Accessory Kit — new Kit for accessory wake-up, system service linkage, on-demand scheduling, and secure trust management.
• Account Kit — LoginWithHuaweiIDButton supports custom multilingual text and loading animation.
• AR Engine — C API camera flash control; ArkTS preview stream image access; 3D Gaussian model loading; ArkTS/C APIs for external camera and sensor data.
• ArkUI / UI Design — system material configuration for Toggle, Tips, Toast, dialogs, menus, popups, custom dialogs, half modals, and Popup; component-level immersive light perception; global reuse pools for @Reusable / @ReusableV2; standard floating windows; title-area customization updates.
• ArkWeb — Chromium kernel upgraded from 132 to 144; new security configuration options.
• AVCodec Kit — H.265 hardware encoder CBRHQ mode; Audio Vivid encoding and C APIs.
• AVSession Kit — new extra-key enum values for scenario-specific AVSession metadata.
• Background Tasks Kit — reminder countdown instances add repeatInterval and repeatCount.
• Core File Kit — UNCACHE open option, recursive listFileExt, mmap-based file mapping, and sharing an app sandbox directory as system-visible.
• Core Vision Kit — image super-resolution and semantic text search over images.
• Data Augmentation Kit — mail intelligence handler for classification, summarization, and todo extraction.
• Device Security Kit — enhanced Star Shield confidential risk-control engine, unified risk-control credentials, privacy policy controls for camera/microphone/location, and file-event subscription/filtering.
• Driver Development Kit — query external USB hubs and develop user-mode drivers.
• Enterprise Data Guard Kit — file classification policy APIs getPolicy and isKia.
• Enterprise Space Kit — query dual-space state and determine whether the workspace is enterprise space.
• FAST Kit — real-number FFT and inverse FFT; intelligent sequence prediction.
• Graphics Accelerate Kit — game prelaunch feature to improve startup experience.
• Image Kit — metadata classes for GIF/JFIF/TIFF/PNG/AVIS plus XMP metadata.
• Input Kit — keyboard and mouse input event injection.
• Live View Kit — auxiliary-area template with percentage progress ring.
• NDK / JSVM — create ArrayBuffer from external memory.
• NearLink Kit — startScan scans all discoverable nearby NearLink devices.
• Network Boost Kit — netBoost.setDataFlowDesc sets flow descriptions from five-tuple data.
• Notification Kit — stronger notification management/display, including half-modal notification settings entry.
• Online Authentication Kit — DID (Decentralized Identifier) key generation, credential import/query/delete, and data signing.
• PDF Kit — convert specified regions across multiple pages into one image.
• Performance Analysis Kit — gray release fault-log collection and HiAppEvent app-freeze warning subscriptions.
• Preview Kit — file acceleration scanning, preload strategy customization, availability query, and file-operation event reporting.
• Push Kit — Live View push messages support Wearable devices.
• Remote Communication Kit — HttpVersionSelectCallback for HTTP version selection, HMS_Rcp_SetRequestGetDataCallback() for streaming upload, HMS_Rcp_SetFormOrder() for ordered forms, and QUIC C API.
• Scenario Fusion Kit — scenario sharing Button supports image, video, and text.
• Share Kit — phone-to-PC/2in1/tablet tap sharing can expose tap position on the receiving side.
• Spatial Recon Kit — 3DGS gaussian editing and spatial photo generation from a single photo.
• Scan Kit — query support for default/custom scan UI on the current device.