创建应用工程

新建模板工程

  1. 进入工程创建页面。

    • MindStudio欢迎界面：左侧菜单选择“Project”，右侧单击“New Project”。
      图1 工程创建界面
    • MindStudio工程界面：在顶部菜单栏中选择“File > New > Project...”。

  2. 在“New Project”窗口中，选择“Ascend App”，选择工程类型，如图2，单击“Next”进入工程配置。（若工程类型名称显示不全，鼠标悬停于工程类型名称处，则工程类型名称可以完整显示。）

    CANN Version：当前激活的CANN版本，可通过单击右侧“Change”进行变更，具体功能使用请参见切换/激活CANN包。

    AscendCL Project为AscendCL空白工程，仅包括开发框架的工程，不含具体的代码逻辑。

    如未在MindStudio中配置CANN，部分应用工程可能无法正常显示。

    图2 AscendCL应用工程

  3. 进入工程配置栏，配置工程相关参数如表1所示。

    表1 工程参数说明

    参数

    说明

    Project name

    工程名称，自行配置。

    名称开头和结尾必须是数字或字母。只能包含字母、数字、中划线和下划线，且长度不超过64个字符。

    Project location

    工程默认保存路径，用户可自定义。（对于首次使用MindStudio的用户，该项默认为“$HOME/MindstudioProjects”。）

    More Settings

    “Module name”：模块名，默认与“Project name”一致。

    “Content root”：根目录下路径。

    “Module file location”：模块文件路径。
    单击“Project format”右侧选框，出现下拉菜单。
    • .idea（directory-based）：创建项目的时候创建一个.idea项来保存项目的信息，默认选项。
    • .ipr（file-based）：项目配置文件来保存项目的配置信息。

  4. 单击Create，完成工程创建。成功创建工程后，工程目录的主要结构如下，请以实际获取为准。

    • AscendCL Project(C/C++)： 
      ├── 工程名
│   ├── build
│   │    ├──cmake             //存放cmake依赖文件。
│   ├── out                    //存放编译出的可执行文件。
│   ├── src
│   │    ├── CMakeLists.txt   //编译脚本。
│   │    ├── main.cpp         //主函数的实现文件，当前主函数内无代码逻辑。
│   ├── CMakeLists.txt         //编译脚本，调用src目录下的CMakeLists文件。
    • AscendCL Project(Python)：无代码目录。

导入应用工程

  1. 导入工程文件，可通过选择以下任意一种方式完成。

    • MindStudio欢迎界面：单击“Open”，选择需要导入的工程，单击“OK”确认导入。
    • MindStudio工程界面：在顶部菜单栏中选择“File > Open...”或单击工具栏中的，选择现有工程打开。

      如该工程存在代码风险，在打开时会弹出信任窗口。

      • 如该工程源码可被信任且安全，请单击“Trust Project”。（可通过勾选“Trust project in <工作区目录>”复选框信任该目录下的所有工程。）
      • 如该工程不被信任，仅用于查看其中源码，请单击“Preview in Safe Mode”进入安全模式预览。
      • 如放弃打开该工程，请单击“Don't Open”取消工程导入操作。

  2. 若工作窗口已打开其他工程，会出现确认提示。

    • 选择“This Window”，则直接在当前工作窗口打开新创建的工程。
    • 选择“New Window”，则新建一个工作窗口打开新创建的工程。

  3. 成功导入工程后，工程目录以树状呈现，请以实际创建结果为准。

新建样例工程

  1. 进入工程创建页面。

    • MindStudio欢迎界面：单击“New Project”。
    • MindStudio工程界面：在顶部菜单栏中选择“File > New > Project...”。

  2. 在“New Project”窗口中，选择“Ascend App”，选择工程类型，如图3。（若工程类型名称显示不全，鼠标悬停于工程类型名称处，则工程类型名称可以完整显示。）

    图3 AscendCL Samples样例工程

    CANN Version：当前激活的CANN版本，可通过单击右侧“Change”进行变更，具体功能使用请参见切换/激活CANN包。

    AscendCL C++ Samples和AscendCL Python Samples为基于AscendCL开发的样例工程。

    如未在MindStudio中配置CANN，部分应用工程可能无法正常显示。

  3. 单击“Next”，浏览器会跳转至对应的Gitee代码仓界面。
  4. 在Gitee代码仓页面下单击“克隆/下载 > 复制”，复制代码包下载链接。
  5. 在开发环境执行命令：git clone URL（其中URL为复制的代码包下载链接），直接将代码包克隆到开发环境。 

    git clone https://gitee.com/ascend/samples.git

  6. 在下载的文件夹中选择需要的样例，然后直接通过MindStudio导入，详情请参见导入应用工程。
父主题： 基于AscendCL开发应用