HarmonyOS之sdkmgr命令的使用

一、简介

• sdkmgr 是一个 HarmonyOS SDK 命令行管理工具，支持查看、安装和卸载 HarmonyOS SDK。

二、查看 SDK 组件

• 显示本地和远程组件命令格式如下：

	sdkmgr list --[options] [<component>] 

• < component >表示组件，取值包括 java/js/native/toolchains/previewer，关于 options 参数，如下表所示：

选项	说明
config=<filePath>	sdkmgr配置文件存放目录，默认为sdkmanager/conf/config.properties
sdk-directory=<filePath>	指定存放SDK的根目录，默认路径为sdkmgr工具根目录的上一级目录
component-file=<filePath>	指定一个文本文件，文件内容指定了需要安装的组件
node-home=<filePath>	指定为Node.js所在的根目录
proxy-type=<none | http | socks>	代理类型，取值为none或者http或者socks
proxy=<host:port>	代理服务器的主机和端口
proxy-user=<username>	代理服务器的用户名和密码，如果存在特殊字符，请对特殊字符进行转义
proxy-password=<password>	如果存在特殊字符，如@、#、*等符号，可能导致配置不生效，建议将特殊字符替换为ASCII码，并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下： !：%21 @：%40 #：%23 ￥：%24 &：%26*：%2A
accept-license	自动签署SDK License协议
no-ssl-verify	访问HarmonyOS SDK下载路径时，是否进行HTTPS的SSL校验，默认进行SSL校验，设置该参数则会关闭SSL校验

• 查询 SDK 组件的示例如下所示：
• • 显示指定路径下所有组件的安装情况：

	sdkmgr list --sdk-directory="/data/sdk"

• • 显示 Java 组件所有 API Version 的最新版本：

	sdkmgr list java

三、安装 SDK 组件

• 安装一个或多个 SDK 组件命令格式如下：

	sdkmgr install --[options] <component1> [<component2>] 

• 安装 SDK 组件的示例如下所示：
• • 安装 Java SDK 最高 API Version 下的最新版本，并指定了 SDK 存储路径：

	sdkmgr install --sdk-directory="/data/sdk" java

• • 同时安装 API Version 为 5 的 Java SDK 和 JS SDK，默认安装路径为 sdkmgr 工具根目录的上一级目录：

	sdkmgr install java:5 js:5	

• • 安装 Java SDK 指定 API Version 版本，需要使用 http 代理来安装，代理信息文件通过 config 参数进行指定：

	sdkmgr install java:5 --config="/data/sdk/config.properties"

• • 其中，config 参数指定的配置文件 config.properties 中包含代理服务器信息和 SDK 存储路径：

	sdk-directory="/data/sdk"
	proxy-type=http
	proxy=host:port
	proxy-user=username
	proxy-password=password

• • 安装 comp.txt 中指定的组件，并安装到指定的目录：

	sdkmgr install --component-file="/data/sdk/comp.txt" --sdk-directory="/data/sdk"

• • 其中，comp.txt 中包含的内容举例如下所示：

	java:5
	js:5
	native:5
	toolchains
	previewer

四、卸载SDK组件

• 卸载一个或多个 SDK 组件命令格式如下：

	sdkmgr uninstall --[options] <component1> [<component2>]

• 卸载 SDK 组件的示例如下所示：
• • 卸载本地的 Java SDK，可以指定具体的 API Version，如果不指定，则会卸载最高 API Version 的最新版本：

	sdkmgr uninstall java：5

• • 同时卸载本地已安装的 API Version 为 5 的最新 Java SDK 和 JS SDK 版本：

	sdkmgr uninstall java:5  js:5	

五、查看 sdkmgr 版本

• 查看 sdkmgr 版本号的命令格式为：

	sdkmgr version | --version

六、查看 sdkmgr 帮助

• 查看 sdkmgr 帮助文档的命令格式为：

	sdkmgr help | --help