安装MindStudio

前提条件

参见环境要求至安装依赖章节，完成安装MindStudio前的准备工作。

操作步骤

1. 双击MindStudio_{version}_win.exe安装包，开始安装MindStudio。
   • 如果是通过MindStudio_{version}_win.exe安装包来使用MindStudio，并希望记录安装过程中的安装步骤，可通过cmd.exe命令行运行如下命令启动安装MindStudio。

     .\MindStudio_{version}_win.exe /LOG=D:\log\install.log
     #“D:\log\install.log”为示例输出安装日志路径，请根据实际情况配置期望输出安装日志的绝对路径及其名称。

     

     若未按照要求配置日志参数“/LOG”，不会生成安装过程日志记录文件，但不影响程序正常安装。

   • 如果是通过MindStudio_{version}_win.zip压缩包来使用MindStudio，请跳过步骤1至步骤9，在解压后的bin目录下双击“MindStudio64.exe”应用程序，直接配置MindStudio。
2. 进入MindStudio Setup界面，单击“Next”，如图1所示。
   图1 MindStudio Setup
   
3. （可选）不是首次安装MindStudio时，可选择是否卸载已有版本。
   • 不卸载已有版本，直接单击“Next”，进入5。
   • 卸载已有版本，勾选需要卸载的已有版本，可选择静默卸载，单击“Next”，进入4。
     图2 卸载旧版本
     
4. （可选）选择需要卸载的项，单击“Uninstall”。卸载完成后单击“Close”。
   图3 卸载MindStudio
   
5. 选择MindStudio的安装路径后，单击“Next”，如图4所示。
   图4 MindStudio安装路径
   
   

   建议安装到C:\ProgramFiles目录下，如果选择安装到其他目录，为避免其他用户修改运行文件，需要取消普通用户的修改权限。

6. 用户根据需要勾选安装选项后，单击“Next”，如图5所示。
   图5 勾选安装选项
   
   • Create Desktop Shortcut：勾选“MindStudio”，创建桌面快捷方式。
   • Update PATH Variable(restart needed)：将MindStudio的启动文件路径加入环境变量PATH中，可从系统命令行直接启动MindStudio。如果勾选此项，MindStudio安装配置完成后会重启操作系统。
   • Update Context Menu：勾选“Add "Open Folder as Project"”后，右键单击文件夹，可以作为MindStudio工程打开。
   • Create Associations：默认不勾选。
7. 选择或创建MindStudio安装路径下的启动菜单文件夹，单击“Install”，如图6所示。
   图6 Start Menu Folder
   
8. 开始安装MindStudio，完成后单击“Next”，如图7所示。
   图7 Installing
   
9. 完成MindStudio安装配置，单击“Finish”，如图8所示。
   图8 Completing MindStudio Setup
   

配置MindStudio

1. 进入MindStudio安装目录的bin文件夹，双击MindStudio应用程序启动MindStudio，导入设置界面，如图9所示界面。
   图9 环境设置
   
   • Config or installation directory：表示从自定义配置目录导入MindStudio设置。

     自定义配置目录所在路径：C:\Users\个人用户\AppData\Roaming\MindStudioMS-{version}，MindStudio设置包括工程界面的个性化设置（例如背景色等信息）等。

   • Do not import settings：不导入设置，若选择该选项，则创建新的配置文件，默认为该选项。

   根据需要选择相关选项后，单击“OK”，进入下一步。

   

   • 若已经安装过低版本MindStudio，再次安装高版本时，则图9界面中也会出现“Previous version”参数，表示是否从低版本导入MindStudio设置，您可以根据需要进行选择。
   • 若已经安装过相同版本MindStudio，且卸载前一版本时未删除C:\Users\个人用户\AppData\Roaming\Huawei\MindStudioMS-{version}目录和C:\Users\个人用户\.mindstudio目录，则安装下个版本时会从步骤1直接进入4。
2. 如果没有报错信息且能正常进入欢迎界面，则表示MindStudio安装成功，如图10所示。
   图10 欢迎界面
   

   表1 参数说明

   参数	说明
   Projects页签（工程管理）
   New Project	创建新工程。
   Open	打开已有工程。
   Get from VCS	用版本控制工具下载代码仓并打开。
   Customize页签（定制化个性设置）
   Color theme	设置颜色主题。
   Accessibility	设置辅助功能，包括设置IDE字体大小和针对红绿色视觉缺陷调整颜色。
   Keymap	设置键盘映射，MindStudio会根据您的环境自动建议预定义的键盘映射，请确保它与您正在使用的操作系统匹配，或者手动选择与您习惯使用的另一个IDE或编辑器中的快捷方式匹配的操作系统。
   Import Settings…	从自定义配置目录导入MindStudio个性化设置。
   All Settings…	进入设置界面。
   Plugins页签（插件管理）
   Marketplace	插件市场，可搜索并下载需要的插件。
   Installed	查看已安装的插件。
   Learn MindStudio页签（MindStudio实用帮助）

   

   安装成功后，Windows本地会出现如下目录：

   • C:\Users\个人用户\.mindstudio：包括Toolkit安装路径（mindstudio.properties文件）、MindStudio属性文件以及隐私声明界面用户所做的操作信息。
   • C:\Users\个人用户\AppData\Local\Huawei\MindStudioMS-{version}：存储MindStudio安装以及启动后的运行日志等信息。
   • C:\Users\个人用户\AppData\Roaming\Huawei\MindStudioMS-{version}：存储用户配置数据目录，包括工程界面的个性化设置（例如背景色等信息）等信息。
3. 创建工程或打开已有工程。
   • 在“Projects”页签单击“New Project”，新建工程。若新建的工程为昇腾算子工程，如图11所示，需要配置Ascend-cann-toolkit开发套件包安装路径，单击“Change”，进入6，后续可根据界面指引进行操作。
     图11 新建昇腾算子工程（示例）
     
   • 在“Projects”页签单击“Open”，打开已有昇腾工程，将弹出如图12所示界面，表示MindStudio提供的功能可能会执行此工程中的潜在恶意代码，打开工程前需进行确认。
     图12 信任窗口
     

     • Trust projects in {此工程所在的目录}：信任此工程所在的目录下的所有工程。
     • Trust Project：信任此工程。
     • Preview in Safe Mode：在安全模式下预览此工程。
     • Don't Open：不打开此工程。
     若打开的已有工程为昇腾工程（以应用工程为例），弹出如下图13提示框，单击“OK”按钮。

     图13 未安装CANN包
     

     弹出如图14窗口，单击“Change”，进入6。

     图14 修改应用工程属性（示例）
     
   

   从“New Project”和“Open”入口新建工程或打开已有工程场景下，界面配置参数详细说明可参见《MindStudio用户指南》的“工程管理 > 工程创建 > 昇腾工程/非昇腾工程”章节。

   在“Projects”页签单击“Get from VCS”，在弹出的版本管理界面中配置Git版本库URL，单击“Clone”，将下载（默认存放至C:\Users\个人用户\MindstudioProjects）并打开工程。

   当从版本管理中下载并打开的工程为昇腾工程时，打开过程与从“Projects”页签单击“Open”打开已有昇腾工程过程一致。

4. 进入如图15所示界面，单击，连接MindStudio所在Windows环境与Ascend-cann-toolkit开发套件包所在远程开发环境。单击“Remote CANN location”选项后面的，在弹出界面中选择Ascend-cann-toolkit开发套件包的安装路径（需要选择到版本号一级）。
   图15 连接远程CANN界面
   
5. 进入SSH连接配置界面，单击按钮，进行SSH连接参数配置，单击“OK”，如图16所示。
   图16 SSH配置
   

   表2 参数及图标说明

   参数及图标	说明
   Host	连接目标地址（IP或域名）。
   Port	连接目标地址的端口号。
   User name	登录目标地址的用户名。
   Authentication type	身份验证方式。有两种方式可选： Password：通过密码验证身份。 Key pair：通过密钥验证身份，可以自行参考通用方式申请SSH密钥。 说明： 对于Euler2.8、2.10 aarch架构、银河麒麟 V10 SP1 aarch架构、OpenEuler、Ubuntu20.04和CentOS8.2，使用Key pair方式来通过密钥验证身份时，需要使用ssh-keygen -m PEM或者ssh-keygen -t rsa -m PEM命令来申请SSH密钥。 申请SSH密钥时，建议设置Passphrase不为空，且符合以下口令复杂度： 口令长度至少8个字符。 口令必须包含如下至少两种字符的组合： 至少一个小写字母 至少一个大写字母 至少一个数字 至少一个特殊字符：`~!@#$%^&*()-_=+\|[{}];:'",<.>/? 和空格 当选择Key pair方式时，默认保存配置过的私钥文件。
   Password	Authentication type选择验证方式为Password时显示，需要填写对应用户名的密码，勾选Save password复选框可以保存密码。 说明： 如果没勾选Save password。那么密码自动会在24小时后清除，届时再次使用到SSH会弹出密码输入框，需要再次输入密码方能执行SSH任务。
   Private key file	Authentication type选择验证方式为Key pair时显示，选择本地私钥文件。
   Passphrase	Authentication type选择验证方式为Key pair时显示，需要填写对应密语。勾选Save password复选框可以保存密语。
   Test Connection	单击该按钮测试连接是否成功。
   	新增SSH连接配置。
   	删除SSH连接配置，选中需要删除的SSH连接配置，单击该按钮删除。
   Lock the current connection	选项置灰，用户不可操作。如果SSH连接被添加到集群管理中，则该选项会自动勾选，SSH连接被锁定，不可修改和删除。

6. 输入远端环境下Ascend-cann-toolkit开发套件包的安装路径，如图17所示。
   图17 Ascend-cann-toolkit开发套件包安装路径
   
7. 进入MindStudio界面，在菜单栏选择File > Settings... > Plugins，在插件市场搜索并安装如下插件工具。
   • Grep Console
   • Pylint
   

   • 若启动MindStudio失败，请参见设置超大内存后无法启动MindStudio处理。
   • 如果在搜索插件工具时，提示网络未连接或者插件不存在，请参见在MindStudio界面安装插件时提示网络未连接或插件不存在处理。
   • 若想指定MindStudio的运行时环境，可在C:\Users\个人用户\AppData\Roaming\Huawei\MindStudioMS-{version}\目录创建MindStudio64.exe.jdk文件，并把用户的JBR或JDK安装目录写进去。
     图18 MindStudio64.exe.jdk（示例）