文档

MindStudio IDE Configuration

  1. After MindStudio IDE is installed, the user license agreement page is displayed when you start MindStudio IDE for the first time, as shown in Figure 1.
    Figure 1 User license agreement
    • Select the check box at the bottom to accept the agreement, and then click Continue to go to 2.
    • Click Exit to close MindStudio IDE.
  2. Open the settings import dialog box, as shown in Figure 2.
    Figure 2 Environment settings
    • Config or installation directory: imports MindStudio IDE settings from a custom configuration directory.

      The directory is in the $HOME/.config/Huawei/MindStudioMS-{version} path. The MindStudio IDE settings include personalized settings of the project UI such as the background color.

    • Do not import settings (default): creates a configuration file without importing settings.

    Select an option as required and click OK.

    • If an earlier MindStudio IDE installation is detected, the Previous version parameter is displayed in the dialog box shown in Figure 2 when you are installing a later version. You can choose whether to import the settings from the earlier version as required.
    • If this version of MindStudio IDE has been installed on the server earlier, and the $HOME/.cache/Huawei/MindStudioMS-{version} and $HOME/.config/Huawei/MindStudioMS-{version} directories have not been deleted during the uninstallation, you will be directed to 3 from 2 when you try to install this version again.
  3. If no error is reported and the welcome page is displayed, MindStudio IDE is successfully installed.
    Figure 3 Welcome page
    Table 1 Parameters

    Parameter

    Description

    Projects tab page (project management)

    New Project

    Create a project.

    Open

    Open an existing project.

    Get from VCS

    Use the version control tool to download the code repository and open it.

    Customize tab page (settings customization)

    Color theme

    Set the color theme.

    Accessibility

    Set auxiliary functions, including setting the IDE font size and adjusting the colors for users with red and green visual problems.

    Keymap

    Set keyboard mapping. MindStudio IDE automatically recommends a predefined keyboard mapping based on your environment. Ensure that it matches the OS you are using. Alternatively, you can manually select an OS that matches the shortcuts in another IDE or editor that you are accustomed to.

    Import Settings...

    Import personalized MindStudio IDE settings from the customized configuration directory.

    All Settings...

    Switch to the Settings page.

    Plugins tab page (plugin management)

    Marketplace

    Search for and download required plugins from the plugin market.

    Installed

    Check the installed plugins.

    Learn tab page (MindStudio IDE help)

    Find the following new directories in $HOME on the MindStudio installation server:

    • $HOME/.mindstudio: stores the MindStudio IDE property file and records of operations performed by users in the privacy statement window.
    • $HOME/.cache/Huawei/MindStudioMS-{version}: stores run logs (log/idea.log) generated after MindStudio IDE is installed and started.
    • $HOME/.config/Huawei/MindStudioMS-{version}: stores user configuration data, including the Toolkit installation path (mindstudio.properties file) and personalized settings (such as the background color) of the project UI.
  4. Create a project or open an existing project.
    • On the Projects tab page, click New Project to create a project. If the new project is an Ascend project, as shown in Figure 4, you need to configure the Ascend-CANN-Toolkit installation path. Click Change, go to step 5, and perform subsequent operations as prompted.
      Figure 4 Creating an Ascend operator project (example)
    • On the Projects tab page, click Open to open an existing project. A dialog box shown in Figure 5 is displayed, indicating that the functions provided by MindStudio IDE may execute potential malicious code in the project. In this case, confirm the code before opening the project.
      Figure 5 Trust configuration window
      • Trust projects in {directory where the project is located}: Trust all projects in the directory where this project is located.
      • Trust Project: Trust this project.
      • Preview in Safe Mode: Preview the project in safe mode.
      • Don't Open: Do not open the project.
      If the opened project is an Ascend project (using an application project as an example), a dialog box shown in Figure 6 is displayed. Click OK.
      Figure 6 CANN package not installed

      In the displayed window, click Change and go to 5.

    For details about the parameters for creating a project from the New Project or Open entry or opening an existing project, see "Project Management" > "Project Creation" > "Ascend Projects" and "Project Management" > "Project Creation" > "Non-Ascend Projects" in MindStudio IDE User Guide.

    On the Projects tab page, click Get from VCS. On the version management page displayed, configure the URL of the Git repository and click Clone to download and open the project (stored in $HOME/MindstudioProjects by default).

    The process of opening an Ascend project downloaded from the version management page is the same as the process of opening an existing Ascend project by clicking Open on the Projects tab page.

  5. Display the window shown in Figure 7.

    If the window is not completely displayed, rectify the fault by following the instructions in How Do I Solve the Problem that Chinese Characters Are Displayed as Garbled Characters and the GUI Is Incompletely Displayed or Is Not Well-Organized?

    Figure 7 Selecting the Ascend-CANN-Toolkit path

    The versions of the Ascend-CANN-Toolkit installed by the installation user in the default path are automatically added to CANN-Toolkit Version. You can directly select the required version and click Finish.

    Default paths of the Ascend-CANN-Toolkit are as follows:
    • root user: /usr/local/Ascend/ascend-toolkit
    • Non-root user: ${HOME}/Ascend/ascend-toolkit

      In the preceding paths, ${HOME} indicates the directory of the current user.

    To select another installed version, click next to CANN-Toolkit Path. In the dialog box displayed, select the installation path of the Ascend-CANN-Toolkit (including the version number x.x.x or the latest level). Click OK. The selected Ascend-CANN-Toolkit version is displayed in CANN-Toolkit Version. Then click Finish.

  6. Enter MindStudio IDE and choose File > Settings > Plugins to search for and install the following plugin tools:
    • Grep Console
    • Pylint

    If the system displays a message indicating that the network is disconnected or the plugin does not exist when you search for a plugin tool, rectify the fault by referring to What Do I Do If a Message Is Displayed Indicating that the Network Is Disconnected or the Plugin Does Not Exist When I Install a Plugin in MindStudio IDE.