麒麟正青春

 

仓颉开发环境及工具安装

仓颉编程开发基础是sdk,sdk对应有Windows、mac、linux安装包，主推vscode工具，需要安装sdk,vscode和vscoce_cangjie插件，其中插件可以下载安装或者通过ide的插件市场安装。

其中dev studio也可以使用仓颉语言开发，目前值对应有Windows、mac版本，需要安装sdk,dev studio和dev studio_cangjie插件，其中插件可以下载安装或者通过ide的插件市场安装。

1、下载vs code并安装，或者通过麒麟系统的软件商店安装

2、安装vscode的关于仓颉的插件cangjie-1.0.0.vsix安装，或者通过命令方式安装：ext install IDE-Innovation-Lab.cangjie

　　安装插件cangjie-1.0.0.vsix如下图

　　 

　　https://cangjie-lang.cn/download 下载sdk和安装插件

　　Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter，启动vscode,快捷键ctrl+P打开命令窗口，粘贴ext install IDE-Innovation-Lab.cangjie即可完成安装插件。

3、安装cangjiesdk

　　参考：https://cangjie-lang.cn/docs?url=%2F1.0.0%2Fuser_manual%2Fsource_zh_cn%2Ffirst_understanding%2Finstall_Community.html

　　wya@wya-pc:~/cangjie-sdk$ source ./envsetup.sh
　　wya@wya-pc:~/cangjie-sdk$ cjc -v
　　Cangjie Compiler: 1.0.0 (cjnative)
　　Target: aarch64-unknown-linux-gnu

安装仓颉工具链: cangjie_sdk

来自官网：https://cangjie-lang.cn/docs?url=%2F1.0.0%2Fuser_manual%2Fsource_zh_cn%2Ffirst_understanding%2Finstall_Community.html

在开发仓颉程序时，必用的工具之一是仓颉编译器，它可以将仓颉源代码编译为可运行的二进制文件，但现代编程语言的配套工具并不止于此，实际上，仓颉为开发者提供了编译器、调试器、包管理器、静态检查工具、格式化工具和覆盖率统计工具等一整套仓颉开发工具链，同时提供了友好的安装和使用方式，基本能做到“开箱即用”。

目前仓颉工具链已适配部分版本的 Linux、macOS 和 Windows 平台，但是仅针对部分 Linux 发行版做了完整功能测试，详情可参阅附录Linux 版本工具链的支持与安装章节，在暂未进行过完整功能测试的平台上，仓颉工具链的功能完整性不受到保证。此外，当前 Windows 平台上的仓颉编译器基于 MinGW 实现，相较于 Linux 版本的仓颉编译器，功能会有部分欠缺。

Linux / macOS

环境准备

Linux

Linux 版仓颉工具链的系统环境要求如下：

架构环境要求
x86_64 glibc 2.22，Linux Kernel 4.12 或更高版本，系统安装 libstdc++ 6.0.24 或更高版本
aarch64 glibc 2.27，Linux Kernel 4.15 或更高版本，系统安装 libstdc++ 6.0.24 或更高版本

除此之外，对于 Ubuntu 18.04，还需要安装相应的依赖软件包：

 
$ apt-get install binutils libc-dev libc++-dev libgcc-7-dev

更多 Linux 发行版的依赖安装命令可以参见附录Linux 版本工具链的支持与安装章节。

此外，仓颉工具链还依赖 OpenSSL 3 组件，由于该组件可能无法从以上发行版的默认软件源直接安装，因此需要自行手动安装，安装方式请参见附录Linux 版本工具链的支持与安装章节。

macOS

macOS 版仓颉工具链支持在 macOS 12.0 及以上版本（aarch64 架构）运行。

使用 macOS 版本前需要安装相应的依赖软件包，可以通过执行以下命令安装：

 
$ brew install libffi

安装指导

首先请前往仓颉官网，下载适配平台架构的安装包：

  • cangjie-sdk-linux-x64-x.y.z.tar.gz：适用于 x86_64 架构 Linux 系统的仓颉工具链
  • cangjie-sdk-linux-aarch64-x.y.z.tar.gz：适用于 aarch64 架构 Linux 系统的仓颉工具链
  • cangjie-sdk-mac-aarch64-x.y.z.tar.gz：适用于 aarch64/arm64 架构 macOS 系统的仓颉工具链

假设这里选择了 cangjie-sdk-linux-x64-x.y.z.tar.gz，下载到本地后，请执行如下命令解压：

 
tar xvf cangjie-sdk-linux-x64-x.y.z.tar.gz

解压完成，可以在当前工作路径下看到一个名为 cangjie 的目录，其中存放了仓颉工具链的全部内容，请执行如下命令完成仓颉工具链的安装配置：

 
source cangjie/envsetup.sh

为了验证是否安装成功，可以执行如下命令：

 
cjc -v

其中 cjc 是仓颉编译器的可执行文件名，如果在命令行中看到了仓颉编译器版本信息，表示已经成功安装了仓颉工具链。值得说明的是，envsetup.sh 脚本只是在当前 shell 环境中配置了工具链相关的环境变量，所以仓颉工具链仅在当前 shell 环境中可用，在新的 shell 环境中，需要重新执行 envsetup.sh 脚本配置环境。

若想使仓颉工具链的环境变量配置在 shell 启动时自动生效，可以在 $HOME/.bashrc 或 $HOME/.zshrc（依 shell 种类而定）等 shell 初始化配置文件的最后加入以下命令：

 
# 假设仓颉安装包解压在 /home/user/cangjie 中
source /home/user/cangjie/envsetup.sh  # 即 envsetup.sh 的绝对路径

配置完成后 shell 启动即可直接使用仓颉编译工具链。

卸载与更新

在 Linux 和 macOS 平台，删除上述仓颉工具链的安装包目录，同时移除上述环境变量（最简单的，可以新开一个 shell 环境），即可完成卸载。

 
$ rm -rf <path>/<to>/cangjie

若需要更新仓颉工具链，需要先卸载当前版本，然后按上述指导重新安装最新版本的仓颉工具链。

Windows

本节以 Windows 10 平台为例，介绍仓颉工具链的安装方式。

安装指导

在 Windows 平台上，仓颉为开发者提供了 exe 和 zip 两种格式的安装包，请前往仓颉官网，选择和下载适配平台架构的 Windows 版安装包。

  • 如果选择 exe 格式的安装包（例如 cangjie-sdk-windows-x64-x.y.z.exe），请直接执行此文件，跟随安装向导点击操作，即可完成安装。

  • 如果选择 zip 格式的安装包（例如 cangjie-sdk-windows-x64-x.y.z.zip），请将它解压到适当目录，在安装包中，仓颉为开发者提供了三种不同格式的安装脚本，分别是 envsetup.bat，envsetup.ps1 和 envsetup.sh，可以根据使用习惯及环境配置，选择一种执行：

    • 若使用 Windows 命令提示符（CMD）环境，请执行：

       
      path\to\cangjie\envsetup.bat

    • 若使用 PowerShell 环境，请执行：

       
      . path\to\cangjie\envsetup.ps1

    • 若使用 MSYS shell、bash 等环境，请执行：

       
      source path/to/cangjie/envsetup.sh

    为了验证是否安装成功，请在以上命令环境中继续执行 cjc -v 命令，如果输出了仓颉编译器版本信息，表示已经成功安装了仓颉工具链。

值得注意的是，基于 zip 安装包和执行脚本的安装方式，类似于 Linux 平台，即 envsetup 脚本所配置的环境变量，只在当前命令行环境中有效，如果打开新的命令行窗口，需要重新执行 envsetup 脚本配置环境。此时，若想使仓颉工具链的环境变量配置在命令提示符或终端启动时自动生效，可以对系统进行如下配置：

  • 若使用 bash 环境，可以根据如下步骤操作：

    在 $HOME/.bashrc 初始化配置文件的最后加入以下命令（$HOME 为当前用户目录的路径）：

     
    # 假设仓颉安装包解压在 /home/user/cangjie 中
source /home/user/cangjie/envsetup.sh  # 即 envsetup.sh 的绝对路径

    配置完成后 bash 启动即可直接使用仓颉编译工具链。

  • 若使用 Windows 命令提示符（CMD）、PowerShell 或其他环境，可以根据如下步骤操作：

    1. 在 Windows 搜索框中，搜索 “查看高级系统设置” 并打开对应窗口；

    2. 点击 “环境变量” 按钮；

    3. 执行如下操作，配置 CANGJIE_HOME 变量：

      1. 在 “用户变量”（为当前用户进行配置）或 “系统变量”（为系统所有用户进行配置）区域中，查看是否已有 CANGJIE_HOME 环境变量。若没有，则点击 “新建” 按钮，并在 “变量名” 字段中输入 CANGJIE_HOME ；若有，则说明该环境可能已经进行过仓颉配置，如果想要继续为当前的仓颉版本进行配置并覆盖原配置，请点击 “编辑” 按钮，进入 “编辑系统变量” 窗口。

      2. 在 “变量值” 字段中输入仓颉安装包的解压路径，若原先已经存在路径，则使用新的路径覆盖原有的路径，例如仓颉安装包解压在 D:\cangjie ，则输入 D:\cangjie 。

      3. 配置完成后 “编辑用户变量” 或 “编辑系统变量” 窗口应如下图所示。确认路径正确配置后点击 “确定” 按钮。

        setup-env-path

    4. 执行如下操作，配置 Path 变量：

      1. 在 “用户变量”（为当前用户进行配置）或 “系统变量”（为系统所有用户进行配置）区域中，找到并选择 Path 变量，点击 “编辑” 按钮，进入 “编辑环境变量” 窗口。

      2. 分别点击 “新建” 按钮，并分别输入 %CANGJIE_HOME%\bin 、 %CANGJIE_HOME%\tools\bin 、 %CANGJIE_HOME%\tools\lib 、 %CANGJIE_HOME%\runtime\lib\windows_x86_64_llvm (%CANGJIE_HOME% 为仓颉安装包的解压路径)。例如，仓库安装包解压在 D:\cangjie ，则新建的环境变量分别为： D:\cangjie\bin 、 D:\cangjie\tools\bin 、 D:\cangjie\tools\lib 、 D:\cangjie\runtime\lib\windows_x86_64_llvm 。

      3. （仅适用于为当前用户设置）点击 “新建” 按钮，并输入当前用户目录路径，并在路径后面添加 .cjpm\bin 。例如用户路径在 C:\Users\bob ，则输入 C:\Users\bob\.cjpm\bin 。

      4. 配置完成后应能在 “编辑环境变量” 窗口中看到配置的路径，例如下图所示。确认路径正确配置后点击 “确定” 按钮。

        setup-env-path

    5. 点击 “确定” 按钮，退出 “环境变量” 窗口。

    6. 点击 “确定” 按钮，完成设置。

    注意：

    设置完成后可能需要重启命令行窗口或重启系统以让设置生效。

    配置完成后 Windows 命令提示符（CMD）或 PowerShell 启动即可直接使用仓颉编译工具链。

卸载与更新

  • 如果选择 exe 格式的安装包进行的安装，运行仓颉安装目录下的 unins000.exe 可执行文件，跟随卸载向导点击操作，即可完成卸载。

  • 如果选择 zip 格式的安装包进行的安装，删除仓颉工具链的安装包目录，同时移除上述环境变量设置（若有），即可完成卸载。

若需要更新仓颉工具链，需要先卸载当前版本，然后按上述指导重新安装最新版本的仓颉工具链。

 

安装指导：vscode和cangjie插件

来自官网：https://cangjie-lang.cn/docs?url=%2F1.0.0%2Ftools%2Fsource_zh_cn%2FIDE%2Finstall_community.html

说明：

本文档部分图片截取于 VSCode 软件界面，仅用于说明仓颉插件在 VSCode 中的使用方法。

下载软件

请在 VSCode 官网下载 VSCode 安装包，建议使用 1.67 或更新版本。仓颉语言 VS Code 插件已上架 VS Code 扩展市场，可以前往仓颉下载中心，

点击Cangjie vscode plugin下面的立即查看，可以跳转到 VSCode 扩展市场进行安装，或在 VSCode 内部扩展界面直接进行安装。

下载项说明是否必选
Visual Studio Code IDE 必选

安装 VSCode

Windows 平台

运行 VSCode 安装文件（例如 VSCodeUserSetup-x64.exe），根据提示选择安装路径，完成 VSCode 的安装。

Linux 平台

本地安装

参考 VSCode 官网安装适合的 Linux 发行版的 VSCode。

远程安装

  1. 在 VSCode 中搜索并安装 Remote - SSH 插件。

  2. 使用 Remote - SSH 进行远程工作，VSCode 会自动在远程主机上安装 Server。linux_arm64 暂时只支持使用 Remote - SSH 的方式进行操作。

macOS 平台

解压下载的压缩包（例如 VSCode-darwin-universal.zip），将解压后的 .app 文件拖拽到应用程序，完成 VSCode 的安装。

安装仓颉插件

仓颉插件可以通过 VSCode 扩展市场直接安装。

  1. 启动 VSCode。

  2. 点击左侧边栏的扩展图标进入扩展市场（或按 Ctrl+Shift+X/Cmd+Shift+X）。

    setupVsix

  3. 搜索插件仓颉，在搜索栏输入关键词Cangjie，找到Cangjie插件后，点击 Install 按钮安装。

    setupVsix

  4. 已经安装的插件可以在 INSTALLED 目录下查看。

    checkVsix

安装仓颉 SDK

仓颉 SDK 主要提供了仓颉语言编译命令（cjc）、仓颉语言官方包管理工具（Cangjie Package Manager，简称 CJPM），以及仓颉格式化工具（Cangjie Formatter，简称 cjfmt）等命令行工具。

正确安装并配置仓颉 SDK 后，可使用工程管理、编译构建、格式化、静态检查和覆盖率统计等功能。开发者可以通过以下两种方式下载 SDK：

  • 离线手动安装。在官网下载 SDK 安装包，并在本地安装部署仓颉 SDK。
  • 通过 VSCode 安装。仓颉插件提供了仓颉 SDK 最新版本的下载和更新功能，开发者可以在 VSCode 完成最新版本仓颉 SDK 的下载和本地环境部署。

下载 SDK

开发者可以自行前往仓颉下载中心，手动下载仓颉 SDK。

Windows 平台

Windows 平台的 SDK 下载内容为：cangjie-sdk-windows-x64-x.y.z.exe 或 cangjie-sdk-windows-x64-x.y.z.zip。

下载 SDK 并放置在本地。若下载 .exe 文件，运行该文件，根据提示选择安装路径并记录该路径。若下载 .zip 文件，解压该文件，记录存储的路径。

SDK 文件夹的目录结构如下：

 
cangjie

├── bin

├── lib

├── modules

├── runtime

├── third_party

├── tools

├── envsetup.bat

├── envsetup.ps1

└── envsetup.sh

Linux 平台

Linux_x64 平台的 SDK 下载内容为：cangjie-sdk-linux-x64-x.y.z.tar.gz。

Linux_AArch64 平台的 SDK 下载内容为：cangjie-sdk-linux-aarch64-x.y.z.tar.gz。

下载 SDK 并放置在本地，记录存储的路径。目录结构如下：

 
cangjie

├── bin

├── include

├── lib

├── modules

├── runtime

├── third_party

├── tools

└── envsetup.sh

macOS 平台

macOS_AArch64 平台的 SDK 下载内容为：cangjie-sdk-mac-aarch64-x.y.z.tar.gz。

下载 SDK 并放置在本地，记录存储的路径。目录结构如下：

 
cangjie

├── bin

├── lib

├── modules

├── runtime

├── third_party

├── tools

└── envsetup.sh

SDK 路径配置

安装完仓颉插件后，即可配置 SDK 的路径。单击左下角齿轮图标，选择设置选项。

setVS

或直接右键单击插件，选择 Extension Settings，进入配置页面。

openSetting

在搜索栏输入 Cangjie，选择侧边栏的 Cangjie Language Support 选项。

languageSupportSetting

配置 CJNative 后端

  1. 找到 Cangjie Sdk: Option 选项，选择后端类型为 CJNative（默认是此选项）。

  2. 找到 Cangjie Sdk Path: CJNative Backend 选项，输入 CJNative 后端 SDK 文件夹所在绝对路径。

  3. 重启 VSCode 生效。

CJNativeSdkPathSet

安装验证

cangjie:create cangjie project view 可视化创建仓颉项目

cangjie:create cangjie project  命令创建仓颉项目

cangjie:build cangjie project 构建仓颉项目

仓颉插件正确安装后vscode标题栏的搜所框点击选择show and run commands > 可以选出对应命令

image

 

通过快捷键 Ctrl + Shift + P（macOS 系统的快捷键为 Command + Shift + P） 调出 VSCode 的命令面板，选择 cangjie: Create Cangjie Project View 命令。

createProjectView

弹出创建仓颉项目页面，说明仓颉 SDK 安装成功。

sdkSuccess

 

下载与安装DevEco Studio

更新时间: 2025-07-25 17:54
 来自于官网：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-software-install 

下载软件

请前往下载中心，登录华为账号后下载DevEco Studio，并根据下载中心页面工具完整性指导进行完整性校验。

DevEco Studio支持Windows和macOS系统，下面将针对两种操作系统的软件安装方式分别进行介绍。

Windows环境

运行环境要求

为保证DevEco Studio正常运行，建议电脑配置满足如下要求：

  • 操作系统：Windows10 64位、Windows11 64位
  • 内存：16GB及以上
  • 硬盘：100GB及以上
  • 分辨率：1280*800像素及以上

安装DevEco Studio

  1. 下载完成后，双击下载的“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导。在如下界面选择安装路径，默认安装于C:\Program Files路径下，也可以单击浏览（B）...指定其他安装路径，然后单击下一步。

     

  2. 在如下安装选项界面勾选DevEco Studio后，单击下一步，直至安装完成。

     

     

  3. 安装完成后，单击Finish完成安装。安装完成后，如有需要请根据配置代理，检查和配置开发环境。

     

    说明
    • DevEco Studio提供开箱即用的开发体验，将HarmonyOS SDK、Node.js、Hvigor、OHPM、模拟器平台等进行合一打包，简化DevEco Studio安装配置流程。
    • HarmonyOS SDK已嵌入DevEco Studio中，无需额外下载配置。HarmonyOS SDK可以在DevEco Studio安装位置下DevEco Studio\sdk目录中查看。

    如需进行OpenHarmony应用开发，可通过Settings > OpenHarmony SDK页签下载OpenHarmony SDK。

     

macOS环境

运行环境要求

为保证DevEco Studio正常运行，建议电脑配置满足如下要求：

  • 操作系统：macOS(X86) 11/12/13/14/15 macOS(ARM) 12/13/14/15
  • 内存：8GB及以上
  • 硬盘：100GB及以上
  • 分辨率：1280*800像素及以上

安装DevEco Studio

  1. 在安装界面中，将“DevEco-Studio.app”拖拽到“Applications”中，等待安装完成。

     

     

  2. 安装完成后，如有需要请根据配置代理，检查和配置开发环境。

     

    说明
    • DevEco Studio提供开箱即用的开发体验，将HarmonyOS SDK、Node.js、Hvigor、OHPM、模拟器平台等进行合一打包，简化DevEco Studio安装配置流程。
    • HarmonyOS SDK已嵌入DevEco Studio中，无需额外下载配置。HarmonyOS SDK可以在DevEco Studio安装位置下DevEco Studio\sdk目录中查看。

    如需进行OpenHarmony应用开发，可通过DevEco Studio > Preferences > OpenHarmony SDK页签下载OpenHarmony SDK。

     

诊断开发环境

为了您开发应用/元服务的良好体验，DevEco Studio提供了开发环境诊断的功能，帮助您识别开发环境是否完备。您可以在欢迎页面单击Diagnose进行诊断。

如果您已经打开了工程开发界面，也可以在菜单栏单击Help > Diagnostic Tools > Diagnose Development Environment进行诊断。

 

DevEco Studio开发环境诊断项包括电脑的配置、网络的连通情况、依赖的工具是否安装等。如果检测结果为未通过，请根据检查项的描述和修复建议进行处理。

启用中文化插件

  • 从DevEco Studio 6.0.0 Beta1版本开始，中文化插件无需下载，默认安装开启。如需切换DevEco Studio语言显示效果，在菜单栏进入File >

Settings...（macOS为DevEco Studio > Settings ） > Appearance & Behavior > System Settings > Language，语言选择Chinese并点击Apply，在弹窗中点击Restart重启即可完成语言切换。

  • 若使用DevEco Studio 6.0.0 Beta1之前版本，请在菜单栏进入File > Settings （macOS为DevEco Studio > Preferences ）> Plugins，选择Installed页签，

在搜索框输入“Chinese”，搜索结果里将出现Chinese(Simplified)，在右侧单击Enable，点击OK，在弹窗中单击Restart，重启DevEco Studio后即可生效。

 插件的安装，下载后的插件可以进入idea--setting--plugins--设置按钮--install plusgin form disk...选择本地磁盘文件进行安装

image

 

在dev studio中创见仓颉项目、安装虚拟机、运行虚拟机、执行程序。如果出现错误解决办法：

在devstudio安装目录D:\Huawei\DevEcoStudio\sdk\default\openharmony\toolchains下，管理员打开cmd执行如下命令：

hdc shell

$ param get const.product.cpu.abilist

x86_64

需要在项目中entry/src中的build-profile.json5文件中添加当前设备支持的apiFilters列表即可：

"buildOption": {
  "cangjieOptions": {
    "abiFilters": ["arm64-v8a","x86_64"],
    "path": "./src/main/cangjie/cjpm.toml"
  },

image

 

image

 

image

 

 

 

posted on 2025-06-27 11:12  麒麟正青春  阅读(84)  评论(0)    收藏  举报

导航