Cangjie Corpus

https://github.com/walter-mitty-pro/cangjie-corpus
Admin
A high-quality knowledge base for the Cangjie programming language, integrating official...
Tokens:852,384
Snippets:7,407
Trust Score:3.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### Example: Put and Get Data in Device KV Store

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/ArkData/cj-apis-distributed_kv_store.md

Demonstrates how to create a KV manager, obtain a DeviceKVStore instance, put a key-value pair, and then retrieve the value using the 'get' method. This example requires obtaining an application context and handles potential BusinessExceptions.

```cangjie
// index.cj

import kit.ArkData.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let manager = DistributedKVStore.createKVManager(KVManagerConfig(Global.abilityContext, "test_kvstore")) // 此处需手动配置模板，获取Context上下文。上下文获取方式请参见使用说明。
    let store = (manager.getKVStore<DeviceKVStore>("test", KVOptions(KVSecurityLevel.S1)) as DeviceKVStore).getOrThrow()
    store.put("key", KVValueType.StringValue("value"))
    store.get("key")
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Setting Window Properties

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/arkui-cj/cj-apis-window.md

Demonstrates how to get the main window and set its properties, such as making it non-touchable.

```APIDOC
## 示例代码

### 示例1（获取主窗口设置不可触属性）

设置主窗口属性为不可触后，点击页面中的按钮将不会有弹窗。

<!-- run -example1 -->

```cangjie
// main_ability.cj

package ohos_app_cangjie_entry

import kit.ArkUI.*
import ohos.app.ability.ui_ability.*

class MainAbility <: UIAbility {
    public init() {
        super()
        registerSelf()
    }

    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
        // 1.获取应用主窗口。
        var window: Window = windowStage.getMainWindow()

        // 2.设置窗口主属性。以设置 ”是否可触“ 属性为例。
        window.setWindowTouchable(false)

        // 3. 为主窗口加载对应的目标页面
        windowStage.loadContent("newPage")
    }
}
```

<!-- run -example1 -->

```cangjie
// newPage.cj

package ohos_app_cangjie_entry

import kit.ArkUI.*
import ohos.arkui.state_macro_manage.*

@Entry
@Component
class newPage{
    func build(){
        Flex(justifyContent: FlexAlign.Center ,alignItems: ItemAlign.Center) {
            Column{
                Text("New Page")
                Button("Untouchable").onClick({ evt
                    => AlertDialogParamWithConfirm(message:"Unreachable")
                }).margin(10.vp)
            }.margin(10.vp)
        }
    }
}
```

![img1](figures/window_touchable_is_false.png)
```

--------------------------------

### Start and Stop BLE Advertising Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/ConnectivityKit/cj-apis-bluetooth-ble.md

Demonstrates how to start BLE advertising with specified parameters and then stop it using the advertising ID. Includes error handling for BusinessException.

```cangjie

import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.*
import ohos.business_exception.BusinessException

let advertisingSettings = AdvertiseSetting()
let manufactureDataUnit = ManufactureData(
    4567u16,
    [1, 2, 3, 4]
)
let serviceDataUnit = ServiceData(
    "00001888-0000-1000-8000-00805f9b34fb",
    [5, 6, 7, 8]
)
let advertisingData = AdvertiseData(
    ["00001888-0000-1000-8000-00805f9b34fb"],
    [manufactureDataUnit],
    [serviceDataUnit],
    includeDeviceName: true
)
let advertisingResponse = AdvertiseData(
    ["00001888-0000-1000-8000-00805f9b34fb"],
    [manufactureDataUnit],
    [serviceDataUnit]
)
let advertisingParams = AdvertisingParams(
    advertisingSettings,
    advertisingData,
    advertisingResponse: advertisingResponse,
    duration: 300
)
var advHandle: UInt32 = 0xFF
try {
    advHandle = startAdvertising(advertisingParams)
    stopAdvertising(advHandle)
} catch (e: BusinessException) {
    Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}", "")
}

```

--------------------------------

### Example: Start and Stop a Download Task

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/BasicServicesKit/cj-apis-request-agent.md

Demonstrates how to create, start, and stop a download task using the Request Agent. Ensure the SystemCapability.Request.FileTransferAgent is available. Handles BusinessException for errors.

```cangjie
// main_ability.cj

import kit.BasicServicesKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.BusinessException

try {
    let context = Global.abilityContext
    let config = Config(
        Action.Download,
        "https://example.com/largefile.zip"
    )
    let task = create(context, config)

    task.start()
    task.stop()
    Hilog.info(0, "test", "成功停止任务")
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Get Albums

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/MediaLibraryKit/cj-apis-file-photo_access_helper.md

Shows how to retrieve albums using the getAlbums function with custom fetch options. This example demonstrates fetching user-created albums and handling potential business exceptions.

```cangjie
// index.cj

import kit.MediaLibraryKit.*
import kit.ArkData.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let ctx = Global.abilityContext // 此处需手动配置模板，获取Context上下文。上下文获取方式请参见使用说明。
    let phAccessHelper = getPhotoAccessHelper(ctx)
    let predicates = DataSharePredicates()
    let fetchOptions: FetchOptions = FetchOptions([], predicates)
    let fetchResult: AlbumResult = phAccessHelper.getAlbums(AlbumType.User,
        AlbumSubtype.UserGeneric, options: fetchOptions)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### StartOptions Constructor Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/AbilityKit/cj-apis-app-ability-start_options.md

Demonstrates how to create a StartOptions instance with specified window mode and display ID. This example requires a try-catch block to handle potential BusinessExceptions.

```cangjie
import kit.AbilityKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let startOptions = StartOptions(windowMode: WindowMode.WindowModeFullscreen, displayId: 0)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Encrypt Data using HUKS

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/UniversalKeystoreKit/cj-apis-security_huks.md

Demonstrates the process of generating a key, initializing a session, and finishing the session to encrypt data using HUKS. This example requires prior setup of HuksOptions for AES encryption.

```cangjie
// index.cj

import kit.UniversalKeystoreKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let keyAlias = "KEY_ALIAS" // 密钥别名，在生成密钥时指定，在加密、解密和删除密钥时使用
    let options = HuksOptions(properties:
        [
            HuksParam(HuksTag.HUKS_TAG_ALGORITHM, Uint32Value(HuksKeyAlg.HUKS_ALG_AES)),
            HuksParam(HuksTag.HUKS_TAG_KEY_SIZE, Uint32Value(HuksKeySize.HUKS_AES_KEY_SIZE_128)),
            HuksParam(
                HuksTag.HUKS_TAG_PURPOSE,
                Uint32Value(HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT | HuksKeyPurpose.HUKS_KEY_PURPOSE_DECRYPT)
            ),
            HuksParam(HuksTag.HUKS_TAG_PADDING, Uint32Value(HuksKeyPadding.HUKS_PADDING_PKCS7)),
            HuksParam(HuksTag.HUKS_TAG_BLOCK_MODE, Uint32Value(HuksCipherMode.HUKS_MODE_CBC))
        ]
    )
    generateKeyItem(keyAlias, options)
    // encrypt
    let handle = initSession(keyAlias, options).handle
    let cipherData = finishSession(handle, options)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Create Directory Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CoreFileKit/cj-apis-file_fs.md

Example of creating a nested directory structure. Ensure necessary imports are included and handle potential BusinessExceptions.

```cangjie
// index.cj

import kit.CoreFileKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let pathDir = "path/to/file"
    let dirPath = pathDir + "/testDir1/testDir2/testDir3"
    FileIo.mkdir(dirPath, true)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Check Webview Back Navigation Capability

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/ArkWeb/cj-apis-webview.md

Demonstrates how to check if the webview can go back using the canGoBack() method and logs the result. Includes basic Web component setup.

```cangjie
// index.cj

import kit.ArkUI.LengthProp
import kit.ArkUI.Button
import kit.ArkUI.Column
import kit.ArkUI.CustomView
import kit.ArkUI.CJEntry
import kit.ArkUI.loadNativeView
import kit.ArkUI.SubscriberManager
import kit.ArkUI.LocalStorage
import ohos.arkui.state_macro_manage.Entry
import ohos.arkui.state_macro_manage.Component
import kit.ArkWeb.*
import kit.ArkUI.Web
import kit.PerformanceAnalysisKit.Hilog

@Entry
@Component
class webview_2 {
    let webController = WebviewController()
    func build() {
        Column(space:10) {
            Button("canGoBack")
            .onClick ({ 
                evt =>
                Hilog.info(0, "cangjieTest", "canGoBack")
                let bool = webController.canGoBack()
                Hilog.info(0, "cangjieTest", "canGoBack returns ${bool}")
            }).width(400.px).height(150.px)

            Web(src: "www.example.com", controller: webController)
            .onPageBegin({evt =>
                Hilog.info(0, "cangjieTest", "page begin url: ${evt.url}")
            })
            .onPageEnd({evt =>
                Hilog.info(0, "cangjieTest", "page end url: ${evt.url}")
            })
        }
    }
}
```

--------------------------------

### start

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CameraKit/cj-apis-multimedia-camera.md

Starts the recording session. This method should be called after the camera session has been configured.

```APIDOC
## start()

### Description
Starts the recording session. This method should be called after the camera session has been configured.

### Method Signature
```cangjie
public func start(): Unit
```

### System Capabilities
- SystemCapability.Multimedia.Camera.Core

### Exceptions
- BusinessException: Refer to Camera Error Codes for details.
  - 7400103: Session not config.
  - 7400201: Camera service fatal error.

### Example
```cangjie
// index.cj

import kit.CameraKit.*
import kit.ImageKit.createImageReceiver
import kit.ImageKit.Size as ImageSize
import kit.ImageKit.ImageFormat
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let ctx = Global.abilityContext // Manual configuration required for Context. See Usage Instructions.
    let cameraManager = getCameraManager(ctx)
    let device = cameraManager.getSupportedCameras()[0]
    let mode = cameraManager.getSupportedSceneModes(device)[1]
    let ability = cameraManager.getSupportedOutputCapability(device, mode)
    let size = ImageSize(8, 8192)
    let receiver = createImageReceiver(size, ImageFormat.Jpeg, 8)
    let surfaceId: String = receiver.getReceivingSurfaceId()
    let output = cameraManager.createVideoOutput(ability.videoProfiles[0], surfaceId)
    output.start()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```
```

--------------------------------

### Start a Task

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/BasicServicesKit/cj-apis-request-agent.md

Start a task. This can be used for newly created tasks or for download tasks that have failed or stopped. Ensure the task is in a valid state before calling `start()`. Permissions and task state errors are handled via `BusinessException`.

```cangjie
import kit.BasicServicesKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.BusinessException

try {
    let context = Global.abilityContext
    let config = Config(
        Action.Download,
        "https://example.com/file.txt"
    )
    let task = create(context, config)

    task.start()
    Hilog.info(0, "test", "成功启动任务")
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Start UIAbility

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/AbilityKit/cj-apis-app-ability-ui_ability.md

Initiates the launch of a UIAbility. This operation is restricted to the main thread. Optional start options can be provided.

```cangjie
public func startAbility(want: Want, options!: ?StartOptions = None): Unit
```

```cangjie
import kit.AbilityKit.*
import kit.ArkUI.WindowStage

class MyUIAbility19 <: UIAbility {
    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
            this.context.startAbility(Want(bundleName: "com.example.cangjieinsight", abilityName: "testAbility"))
    }
}
```

--------------------------------

### Example module.json5 Configuration

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/cj-start/basic-knowledge/module-configuration-file.md

This snippet shows a comprehensive example of a module.json5 file, detailing various configuration options for an OpenHarmony module, including module metadata, abilities, permissions, and device types.

```json
{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "srcEntry": "ohos_app_cangjie_entry.MyAbilityStage",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "default",
      "tablet"
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "virtualMachine": "ark",
    "appStartup": "$profile:app_startup_config",
    "metadata": [
      {
        "name": "string",
        "value": "string",
        "resource": "$profile:distributionFilter_config"
      }
    ],
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "ohos_app_cangjie_entry.MainAbility",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:layered_image",
        "label": "$string:EntryAbility_label",
        "startWindow": "$profile:start_window",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "ohos.want.action.home"
            ]
          }
        ],
        "continueType": [
          "continueType1"
        ],
        "continueBundleName": [
          "com.example.myapplication1",
          "com.example.myapplication2"
        ]
      }
    ],
    "requestPermissions": [
      {
        "name": "ohos.abilitydemo.permission.PROVIDER",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "FormAbility"
          ],
          "when": "inuse"
        }
      }
    ],
    "targetModuleName": "feature",
    "targetPriority": 50,
    "querySchemes": [
      "app1Scheme",
      "app2Scheme"
    ],
    "appEnvironments": [
      {
        "name": "name1",
        "value": "value1"
      }
    ],
    "hnpPackages": [
      {
        "package": "hnpsample.hnp",
        "type": "public"
      }
    ],
    "fileContextMenu": "$profile:menu"
  }
}
```

--------------------------------

### Example User-Agent String

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/web/cj-web-default-userAgent.md

An example of a User-Agent string for a mobile OpenHarmony device.

```text
Mozilla/5.0 (Phone; OpenHarmony 5.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36  ArkWeb/4.1.6.1 Mobile
```

--------------------------------

### Generate Symmetric Key and Initialize Mac

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CryptoArchitectureKit/cj-apis-crypto.md

Generates a random symmetric key using a specified key generator and then initializes a Mac instance with this key. This example demonstrates the setup for MAC computation.

```cangjie
// index.cj

import kit.CryptoArchitectureKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let skg = createSymKeyGenerator("AES128")
    let sk = skg.generateSymKey()
    let mac = createMac("SHA256")
    mac.initialize(sk)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### start

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/BasicServicesKit/cj-apis-request-agent.md

Starts a task. This method can be used to initiate a newly created task or to restart a download task that has failed or stopped.

```APIDOC
## start

### Description
Starts a task. This method can be used to initiate a newly created task or to restart a download task that has failed or stopped.

### Method
public func start(): Unit

### Permissions
ohos.permission.INTERNET

### Exception
- BusinessException: Indicates an error occurred during the operation. Refer to the error code table for details.

### Request Example
```cangjie
// main_ability.cj

import kit.BasicServicesKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.BusinessException

try {
    let context = Global.abilityContext
    let config = Config(
        Action.Download,
        "https://example.com/file.txt"
    )
    let task = create(context, config)

    task.start()
    Hilog.info(0, "test", "成功启动任务")
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```
```

--------------------------------

### Image Release Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/ImageKit/cj-apis-image.md

Example demonstrating how to read an image and then release its resources. Ensure to handle potential BusinessExceptions during the process.

```cangjie
// index.cj

import kit.ImageKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let size = Size(8, 8192)
    let receiver = createImageReceiver(size, ImageFormat.Jpeg, 8)
    let img = receiver.readNextImage()
    img.release()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Create Temporary Directory Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CoreFileKit/cj-apis-file_fs.md

Example of creating a temporary directory with a specified prefix. The 'XXXXXX' suffix is crucial for uniqueness. Handle potential BusinessExceptions.

```cangjie
// index.cj

import kit.CoreFileKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let pathDir = "path/to/file"
    let res = FileIo.mkdtemp(pathDir + "/XXXXXX")
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Move Directory Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CoreFileKit/cj-apis-file_fs.md

Example of moving a directory with a specified mode. Ensure correct source and destination paths are provided and handle potential BusinessExceptions.

```cangjie
// index.cj

import kit.CoreFileKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let pathDir = "path/to/file"
    // move directory from srcPath to destPath
    let srcPath = pathDir + "/srcDir/"
    let destPath = pathDir + "/destDir/"
    FileIo.moveDir(srcPath, destPath, mode: 1)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Dump All Installed Bundles

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/tools/cj-bm-tool.md

Queries and displays the bundle names of all installed applications on the device using the -a flag.

```bash
bm dump -a
```

--------------------------------

### Scene Example: Bluetooth Switch

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/arkui-cj/cj-common-components-switch.md

A practical example demonstrating the use of a Toggle component to control a Bluetooth switch and display toast messages based on its state.

```APIDOC
## Scene Example: Bluetooth Switch

This example shows how to use a Toggle component to simulate a Bluetooth switch, displaying a toast message when the switch state changes.

```cangjie
package ohos_app_cangjie_entry
import kit.ArkUI.*
import ohos.arkui.ui_context.*
import ohos.arkui.state_macro_manage.*

@Entry
@Component
class EntryView {
    func build() {
        Column() {
            Row() {
                Text("Bluetooth Mode")
                    .height(50)
                    .fontSize(16)
            }
            Row() {
                Text("Bluetooth")
                    .height(50)
                    .padding(left: 10)
                    .fontSize(16)
                    .textAlign(TextAlign.Start)
                    .backgroundColor(0xFFFFFF)
                Toggle(ToggleType.Switch)
                    .margin(left: 200, right: 10)
                    .onChange ({ isOn =>
                        if (isOn) {
                            getUIContext().getPromptAction().showToast(ShowToastOptions(message: 'Bluetooth is on.'))
                        } else {
                            getUIContext().getPromptAction().showToast(ShowToastOptions(message: 'Bluetooth is off.'))
                        }
                    })
            }.backgroundColor(0xFFFFFF)
        }
            .padding(10)
            .backgroundColor(0xDCDCDC)
            .width(100.percent)
            .height(100.percent)
    }
}
```
```

--------------------------------

### Example: Get MAC Length

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CryptoArchitectureKit/cj-apis-crypto.md

Shows how to get the MAC length after performing MAC operations. Includes error handling for BusinessException.

```cangjie
// index.cj

import kit.CryptoArchitectureKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let mac = createMac("SHA256")
    let skg = createSymKeyGenerator("AES128")
    let sk = skg.generateSymKey()
    mac.initialize(sk)
    let blob = DataBlob("this is test!".toArray())
    mac.update(blob)
    mac.doFinal()
    var macLen = mac.getMacLength()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Main Ability Window Setup

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/arkui-cj/cj-apis-window.md

This snippet shows the basic setup for a main ability, including loading content and storing the window stage for later use. It's essential for initializing the application's main window.

```cangjie
// main_ability.cj

package ohos_app_cangjie_entry

import ohos.app.ability.ui_ability.*
import kit.ArkUI.*

class MainAbility <: UIAbility {

    public init() {
        super()
        registerSelf()
    }

    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
        windowStage.loadContent("newPage")
        // 将该Ability的窗口管理器传入AppStorage中
        AppStorage.setOrCreate("windowStage",windowStage)
    }
}
```

--------------------------------

### TextTimer Starts Automatically on Appear

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/arkui-cj/cj-information-display-texttimer.md

This example demonstrates how to make the TextTimer component start counting immediately after it appears on the screen. The onAppear lifecycle callback is used to trigger the start action via the controller.

```cangjie
package ohos_app_cangjie_entry

import kit.ArkUI.*
import ohos.hilog.*
import ohos.arkui.state_macro_manage.*

@Entry
@Component
class EntryView {
    var textTimerController: TextTimerController = TextTimerController()
    @State var format: String = 'mm:ss.SS'

    func build() {
        Column(space: 8) {
            Scroll().height(20.percent)
            Button("openTextTimer").onClick({
                evt =>

            })
            TextTimer( isCountDown: true, count: 30000, controller: this.textTimerController )
                .format(this.format)
                .fontColor(Color.Black)
                .fontSize(50)
                .onTimer({
                    utc: Int64, elapsedTime: Int64 =>
                        Hilog.info(0, "AppLogCj", 'textTimer notCountDown utc is：${utc.toString()}, elapsedTime: ${elapsedTime.toString()}')
                })
                .onAppear({
                    =>
                    this.textTimerController.start()
                })
        }
    }
}
```

--------------------------------

### Example: MAC Calculation with doFinal

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CryptoArchitectureKit/cj-apis-crypto.md

Demonstrates MAC calculation using createMac, initialize, update, and doFinal. Handles BusinessException for errors.

```cangjie
// index.cj

import kit.CryptoArchitectureKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let mac = createMac("SHA256")

    let skg = createSymKeyGenerator("AES128")
    let sk = skg.generateSymKey()
    mac.initialize(sk)
    let blob = DataBlob("this is test!".toArray())
    mac.update(blob)
    mac.doFinal()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Cold Start UIAbility Instance

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/application-models/cj-uiability-intra-device-interaction.md

This snippet demonstrates the onCreate() and onWindowStageCreate() lifecycle methods for a UIAbility during a cold start. It shows how to initialize UI elements and load content based on initial parameters.

```cangjie
import std.collection.HashMap
import kit.AbilityKit.{UIAbility, LaunchParam, Want}
import kit.PerformanceAnalysisKit.Hilog

var globalFuncAbilityAContext:?UIAbilityContext = None
class FuncAbilityA <: UIAbility {
    var url = "Index"
    public override func onCreate(want: Want, launchParam: LaunchParam): Unit {
        // 接收调用方Ability传过来的参数
        let funcAbilityWant = want
        let info = "XXX"
        // want.parameters是一个json格式的字符串，用户可通过三方json库解析出router字段的值，赋给info
        if (info == "FuncA") {
            url = "PageColdStartUp"
        }
    }

    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
        Hilog.info(0, "device_interaction", "FuncAbilityA onWindowStageCreate.")
        globalFuncAbilityAContext = this.context
        windowStage.loadContent(url)
    }
}
```

--------------------------------

### Example: Using listFile with Options

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CoreFileKit/cj-apis-file_fs.md

Demonstrates listing files in a directory with specific filters (image suffixes and names containing 'abc' or 'efg') and disabling recursion. Includes error handling.

```cangjie
// index.cj

import kit.CoreFileKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let pathDir = "path/to/file"
    let filter = Filter(suffix: [".png", ".jpg", ".jpeg"], displayName: ["*abc", "efg*"])
    let listFileOptions = ListFileOptions(recursion: false, listNum: 0, filter: filter)
    let filenames = FileIo.listFile(pathDir, options: listFileOptions)
    for (name in filenames) {
        Hilog.info(0, "test", name, "")
    }
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Using fsync

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CoreFileKit/cj-apis-file_fs.md

Shows how to synchronize file data to disk after opening a file. It includes error handling for `BusinessException`.

```cangjie
// index.cj

import kit.CoreFileKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let pathDir = "path/to/file"
    let filePath = pathDir + "/test.txt"
    let file = FileIo.open(filePath)
    FileIo.fsync(file.fd)
    FileIo.close(file)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Implement AbilityStage with onCreate (Alternative)

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/AbilityKit/cj-apis-app-ability-ability_stage.md

Another example demonstrating the implementation of AbilityStage and its onCreate callback for module initialization.

```cangjie
import kit.AbilityKit.*

class MyAbilityStage2 <: AbilityStage {
    public override func onCreate(): Unit {
        let context = this.context
    }
}
```

--------------------------------

### Install Time Property

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/AbilityKit/cj-apis-bundle_manager.md

The installation timestamp of the application bundle in milliseconds since the Unix epoch (1970-01-01 08:00:00 UTC+8). If the device time is not obtained during initial boot, the timestamp is based on the system's starting time.

```cangjie
public let installTime: Int64

```

--------------------------------

### Get Permission Usage Record Status

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/tools/cj-atm-tool.md

Example of retrieving the current status of the permission usage record for a specific user.

```bash
atm toggle -u -o -i 0
```

--------------------------------

### Get Camera Permission Popup Status

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/tools/cj-atm-tool.md

Example of retrieving the current status of the camera permission popup for a specific user.

```bash
atm toggle -r -o -i 0 -p ohos.permission.CAMERA
```

--------------------------------

### Example: Using fdopenStream

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CoreFileKit/cj-apis-file_fs.md

Demonstrates opening a file for reading and writing using `fdopenStream` after opening it with `FileIo.open`. It includes error handling for `BusinessException`.

```cangjie
// index.cj

import kit.CoreFileKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let pathDir = "path/to/file"
    let filePath = pathDir + "/test.txt"
    let file = FileIo.open(filePath, mode: (OpenMode.READ_ONLY | OpenMode.CREATE))
    let stream = FileIo.fdopenStream(file.fd, "r+")
    FileIo.close(file)
    stream.close()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Cangjie Property: rowIndex

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/ArkData/cj-apis-relational_store.md

Gets the index of the current row in the result set. Defaults to -1. Indexing starts from 0.

```cangjie
public prop rowIndex: Int32
```

--------------------------------

### Example: Get MD Length

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CryptoArchitectureKit/cj-apis-crypto.md

Shows how to obtain the MD length for a given algorithm. Includes error handling for BusinessException.

```cangjie
// index.cj

import kit.CryptoArchitectureKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let md = createMd("SHA256")
    let mdLen = md.getMdLength()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### FileSpec Initialization Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/BasicServicesKit/cj-apis-request-agent.md

Demonstrates how to create a FileSpec object with a specified path, mime type, and filename. Includes error handling for potential exceptions during object creation.

```cangjie
// main_ability.cj

import kit.BasicServicesKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.BusinessException

try {
    let fileSpec = FileSpec(
        "./example.txt",
        mimeType: "text/plain",
        filename: "example.txt"
    )
    Hilog.info(0, "test", "成功创建文件规范对象")
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Get Asset from ResultSet Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/ArkData/cj-apis-relational_store.md

Demonstrates querying data and retrieving an Asset from a specific column using its index. Includes error handling for BusinessExceptions.

```cangjie
// index.cj

import kit.ArkData.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    var rdbStore: RdbStore = getRdbStore(Global.abilityContext,
        StoreConfig(RelationalStoreSecurityLevel.S1, name: "RdbTest.db")) // 此处需手动配置模板，获取Context上下文。上下文获取方式请参见使用说明。
    let resultSet = rdbStore.querySql("SELECT * FROM EMPLOYEE WHERE NAME = 'Peter'")
    let doc = resultSet.getAsset(resultSet.getColumnIndex("DOC"))
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Get Device Capability

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/LocalizationKit/cj-apis-resource_manager.md

Retrieves the DeviceCapability object for the current device. This requires the Global.ResourceManager system capability and is available starting from API version 22.

```cangjie
import kit.LocalizationKit.*
import kit.PerformanceAnalysisKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let resourceManager = Global.abilityContext.resourceManager
    let deviceCapability = resourceManager.getDeviceCapability()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Correct @Provide for @Consume Initialization

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/arkui-cj/state_management/cj-macro-provide-and-consume.md

This example demonstrates the correct setup where a @Provide variable in the parent component correctly initializes the @Consume variable in the child component.

```cangjie
@Component
class Child{
    @Consume
    var num: Int64

    func build(){
        Column(){
            Text("num的值：${this.num}")
        }
    }
}

// 父组件
@Entry
@Component
class EntryView{
    // 正确写法
    @Provide
    var num: Int64 = 10;

    func build(){
        Column(){
            Text("num的值：${this.num}")
            Child()
        }
    }
}
```

--------------------------------

### Example: Setting Event Package Size and Retrieving Events

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/PerformanceAnalysisKit/cj-apis-hiappevent.md

Demonstrates adding a watcher, creating an AppEventPackageHolder, setting the size threshold for event packages, and handling potential business exceptions.

```cangjie
// index.cj

import kit.PerformanceAnalysisKit.*
import ohos.business_exception.BusinessException

try {
    // 添加数据观察者“Watcher1”，订阅监听系统事件
    HiAppEvent.addWatcher(
        Watcher(
            "Watcher1",
            appEventFilters: [ AppEventFilter("button")]
        )
    )

    let holder = AppEventPackageHolder("watcher2")
    holder.setSize(100)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Update MAC with DataBlob

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/CryptoArchitectureKit/cj-apis-crypto.md

Illustrates updating the MAC with a DataBlob. Ensure proper initialization before calling update. Includes error handling.

```cangjie
// index.cj

import kit.CryptoArchitectureKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let mac = createMac("SHA256")
    let skg = createSymKeyGenerator("AES128")
    let sk = skg.generateSymKey()
    mac.initialize(sk)
    let blob = DataBlob("this is test!".toArray())
    mac.update(blob)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Handling HTTP Response Headers Once

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/NetworkKit/cj-apis-net-http.md

Demonstrates how to use the `once` function to subscribe to HTTP response headers and log them. This example includes setting up a custom callback class and handling potential BusinessExceptions. Ensure necessary imports are present.

```cangjie
// index.cj

import kit.NetworkKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.BusinessException
import std.collection.HashMap
import ohos.callback_invoke.*

// 定义HeadersReceiveCb类
class HeadersReceiveCb2 <: Callback1Argument<HashMap<String, String>> {
    let callback_: (HashMap<String, String>)->Unit
    public init(callback: (HashMap<String, String>)->Unit) {callback_ = callback}
    public func invoke(err: ?BusinessException, val: HashMap<String, String>): Unit {
        callback_(val)
    }
}

try {
    let client = createHttp()

    let onceHeadersReceiveCallBack = HeadersReceiveCb2({ map => Hilog.info(0, "test", "header info once: ${map}") })
    client.once(HttpRequestEvent.HeadersReceive, onceHeadersReceiveCallBack)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Example: Set Main Window to Untouchable

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/arkui-cj/cj-apis-window.md

Demonstrates how to get the main window and set its 'touchable' property to false, making it unresponsive to clicks. This is useful for preventing accidental interactions with the main window.

```cangjie
// main_ability.cj

package ohos_app_cangjie_entry

import kit.ArkUI.*
import ohos.app.ability.ui_ability.*

class MainAbility <: UIAbility {
    public init() {
        super()
        registerSelf()
    }

    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
        // 1.获取应用主窗口。
        var window: Window = windowStage.getMainWindow()

        // 2.设置窗口主属性。以设置 ”是否可触“ 属性为例。
        window.setWindowTouchable(false)

        // 3. 为主窗口加载对应的目标页面
        windowStage.loadContent("newPage")
    }
}
```

```cangjie
// newPage.cj

package ohos_app_cangjie_entry

import kit.ArkUI.*
import ohos.arkui.state_macro_manage.*

@Entry
@Component
class newPage{
    func build(){
        Flex(justifyContent: FlexAlign.Center ,alignItems: ItemAlign.Center) {
            Column{
                Text("New Page")
                Button("Untouchable").onClick({ evt
                    => AlertDialogParamWithConfirm(message:"Unreachable")
                }).margin(10.vp)
            }.margin(10.vp)
        }
    }
}
```

--------------------------------

### Initialize and Configure RdbStore

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/database/cj-data-persistence-by-rdb-store.md

This snippet demonstrates how to initialize and configure an RdbStore, including setting security levels, database names, encryption, and custom directories. It also shows basic table creation and alteration using SQL.

```cangjie
import ohos.business_exception.BusinessException
import kit.ArkData.*
import kit.AbilityKit.getStageContext
import std.collection.HashMap
import kit.AbilityKit.{UIAbility, AbilityStage, Want, LaunchParam, LaunchReason, UIAbilityContext}
import ohos.data.relational_store.RdbStore
import kit.ArkData.{StoreConfig, getRdbStore, RdbPredicates, deleteRdbStore}
import ohos.data.relational_store.RelationalStoreSecurityLevel
import kit.ArkUI.{WindowStage}

let storeConfig = StoreConfig(
RelationalStoreSecurityLevel.S3,// 数据库安全级别
name: "RdbTest.db", // 数据库文件名
encrypt: false, // 可选参数，指定数据库是否加密，默认不加密
customDir: "customDir/subCustomDir", // 可选参数，数据库自定义路径。数据库将在如下的目录结构中被创建：context.databaseDir + '/rdb/' + customDir，其中context.databaseDir是应用沙箱对应的路径，'/rdb/'表示创建的是关系型数据库，customDir表示自定义的路径。当此参数不填时，默认在本应用沙箱目录下创建RdbStore实例。
)

// 判断数据库版本，如果不匹配则需进行升降级操作
// 假设当前数据库版本为3，表结构：EMPLOYEE (ID, NAME, AGE, SALARY, CODES)
const SQL_CREATE_TABLE = "CREATE TABLE EMPLOYEE(ID int NOT NULL, NAME varchar(255) NOT NULL, AGE int, SALARY float NOT NULL, CODES Bit NOT NULL, PRIMARY KEY (Id))"
var rdbStore: Option<RdbStore> = Option<RdbStore>.None

// 此处示例在Ability中实现，使用者也可以在其他合理场景中使用
class MainAbility <: UIAbility {
    public init() {
        super()
        registerSelf()
    }

    public override func onCreate(want: Want, launchParam: LaunchParam): Unit {
        match (launchParam.launchReason) {
            case LaunchReason.StartAbility => Hilog.info(0, "cangjie", "START_ABILITY")
            case _ => ()
        }
    }

    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
        Hilog.info(0, "cangjie", "MainAbility onWindowStageCreate.")
        windowStage.loadContent("EntryView")
        let store = getRdbStore(this.context, storeConfig) // 创建数据库实例
        store.executeSql(SQL_CREATE_TABLE) // 创建数据表
        store.executeSql('ALTER TABLE EMPLOYEE ADD COLUMN AGE INTEGER')
        store.executeSql('ALTER TABLE EMPLOYEE DROP COLUMN ADDRESS TEXT')
        rdbStore = store
        // 进行数据库的增、删、改、查等操作
        // ...
    }
    // ...
}

```

--------------------------------

### Get UIAbility Context in Page (Method 1)

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/application-models/cj-uiability-usage.md

Obtain the UIAbility context within a page by calling a helper function `getContext()` that retrieves the global context. This context can then be used to start other abilities.

```cangjie
import kit.AbilityKit.{UIAbilityContext, Want}

func getContext(): UIAbilityContext {
    return globalContext.getOrThrow()
}

@Entry
@Component
class EntryView {
    @State
    var context: UIAbilityContext = getContext()

    func startAbilityTest(): Unit {
        let want = Want(
            // Want参数信息
        )
        context.startAbility(want)
  }

    // 页面展示
    func build() {
        // ...
    }
}
```

--------------------------------

### Example: Saving Media Files with Callback

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/MediaLibraryKit/cj-apis-file-photo_access_helper.md

Demonstrates how to use the showAssetsCreationDialog API to save media files. It includes setting up a callback to handle the results, defining source file URIs and creation configurations, and handling potential business exceptions. Ensure you obtain the correct Context and PhotoAccessHelper instance.

```cangjie
// index.cj

import kit.MediaLibraryKit.*
import kit.ArkData.*
import ohos.business_exception.BusinessException
import ohos.callback_invoke.*
import kit.PerformanceAnalysisKit.Hilog

// 此处代码可添加在依赖项定义中
class MyCallback1<T> <: Callback1Argument<T> {
    public let callabck_: (T) -> Unit
    public init(callabck: (T) -> Unit) {
        callabck_ = callabck
    }
    public func invoke(err: ?BusinessException, arg: T): Unit {
        callabck_(arg)
    }
}

try {
    let ctx = Global.abilityContext // 此处需手动配置模板，获取Context上下文。上下文获取方式请参见使用说明。
    let phAccessHelper = getPhotoAccessHelper(ctx)
    let callback = MyCallback1<Array<String>>(
        {
            arg: Array<String> =>
            Hilog.info(0, "AppLogCj", "oncallback: Array.size: ${arg.size}")
            for (str in arg) {
                Hilog.info(0, "AppLogCj", "oncallback: uri: ${str}")
            }
        }
    )
    // 获取需要保存到媒体库的位于应用沙箱的图片/视频uri
    // 实际场景请使用真实的uri
    let srcFileUris: Array<String> = ["file://media/Photo/37/IMG_1731463495_028/IMG_20241113_100315.jpg"]
    let photoCreationConfigs: Array<PhotoCreationConfig> = [
        PhotoCreationConfig(
            'jpg',
            PhotoType.Image,
            title: "test4",
            subtype: PhotoSubtype.Default
        )
    ]
    phAccessHelper.showAssetsCreationDialog(srcFileUris, photoCreationConfigs, callback)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Webview Integration Example

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/arkui-cj/cj-web-web.md

Demonstrates the integration of Webview components, including reload and loadUrl functionalities, along with page begin and end event handling. This example requires importing necessary ArkUI and Webview kits.

```cangjie
package ohos_app_cangjie_entry
import kit.ArkUI.*
import ohos.arkui.state_macro_manage.*
import ohos.web.webview.*
import ohos.hilog.Hilog

@Entry
@Component
class EntryView {
    let webController = WebviewController()
    @State var url: String = "www.example.com"
    func build() {
        Column(space: 10) {
            Button("reload")
            .onClick({
                evt =>
                Hilog.info(0, "AppLogCj", "reload")
                webController.reload()
            }).width(400.px).height(150.px)
            Button("loadUrl")
            .onClick({
                evt =>
                Hilog.info(0, "AppLogCj", "loadUrl")
                webController.loadUrl(this.url)

            }).width(400.px).height(150.px)
            Web(src: "www.example.com", controller: webController)
            .onPageBegin({evt =>
                Hilog.info(0, "AppLogCj", "page begin url: ${evt.url}")
            })
            .onPageEnd({evt =>
                Hilog.info(0, "AppLogCj", "page end url: ${evt.url}")
            })
        }
    }
```

--------------------------------

### Get Locales

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/reference/LocalizationKit/cj-apis-resource_manager.md

Retrieves the list of locales for the application. By default, it only includes application resources. Set includeSystem to true to also include system resources. This API is available starting from API version 22.

```cangjie
import kit.LocalizationKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let resourceManager = Global.abilityContext.resourceManager
    resourceManager.getLocales()
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}
```

--------------------------------

### Query All Application Process Information

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/tools/cj-atm-tool.md

Example of querying token IDs and package names for all application processes in the system.

```bash
atm dump -t
```

--------------------------------

### Get Device API Version

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/tools/cj-bm-tool.md

Query the device's API version to diagnose installation failures related to SDK version mismatches. This helps in understanding if the device firmware is compatible with the application's build SDK.

```bash
hdc shell param get const.ohos.apiversion
```

--------------------------------

### ohos.app.ability.start_options API

Source: https://github.com/walter-mitty-pro/cangjie-corpus/blob/main/OpenHarmony-UI开发/application-dev/website.md

API for specifying options when starting an ability.

```APIDOC
## ohos.app.ability.start_options

### Description
The `start_options` module allows developers to specify various options when starting an ability, such as launch flags, background modes, and mission stack behavior.

### Example Options
- `setLaunchFlags()`
- `setAbilityInfo()`
```
Tokens:
Raw