HarmonyOS应用开发-工程模板创建

小嵌

HarmonyOS应用开发-工程模板创建,   
创建一个新的工程

当开始开发一个HarmonyOS应用时，首先需要根据工程创建向导，创建一个新的工程，工具会自动生成对应的代码和资源模板。 如果创建的工程包含JS语言，请确保已经下载了JS SDK包，具体可参考下载HarmonyOS SDK。 说明

在运行DevEco Studio工程时，建议每一个运行窗口有2GB以上的可用内存空间。
创建和配置新工程

• 通过如下两种方式，打开工程创建向导界面。
  
    
  
     
  • 如果当前未打开任何工程，可以在DevEco Studio的欢迎页，选择Create HarmonyOS Project开始创建一个新工程。
       
  • 如果已经打开了工程，可以在菜单栏选择File > New > New Project来创建一个新工程。
      
      
  
  
• 根据工程创建向导，选择需要进行开发的设备类型，然后选择对应的Ability模板。
    
  
• 点击Next，进入到工程配置阶段，需要根据向导配置工程的基本信息。
  
    
  
     
  • Project name：工程的名称，可以自定义。
       
  • Package name：软件包名称，默认情况下，应用ID也会使用该名称，应用发布时，应用ID需要唯一。
       
  • Save location：工程文件本地存储路径。
       
  • Compatible SDK：兼容的SDK版本。
      
      
  
  
• 点击Finish，工具会自动生成示例代码和相关资源，等待工程创建完成。
    
  

导入现有工程 导入现有工程分为以下两种情况：

• 导入DevEco Studio创建的HarmonyOS应用工程：
  
    
  
     
  • 如果当前未打开任何工程，可以在DevEco Studio的欢迎页，选择Open Project打开现有工程。
       
  • 如果已经打开了工程，可以在菜单栏选择File > Open来打开现有工程。
      
      
  
  
• 导入其它IDE创建的工程，比如导入Visual Studio Code创建的轻量级智能穿戴HarmonyOS应用工程：
  
    
  
     
  • 如果当前未打开任何工程，可以在DevEco Studio的欢迎页，选择Import Project导入现有工程。
       
  • 如果已经打开了工程，可以在菜单栏选择File > Import Project导入现有工程。
      
      
  
  

导入现有工程时，DevEco Studio会提醒您可以选择在新的窗口打开工程，或者选择在当前窗口打开工程。


在工程中添加Module

Module是HarmonyOS应用的基本功能单元，包含了源代码、资源文件、第三方库及应用清单文件，每一个Module都可以独立进行编译和运行。一个HarmonyOS应用通常会包含一个或多个Module，因此，可以在工程中，创建多个Module，每个Module分为Ability和Library（HarmonyOS Library和Java Library）两种类型。 如HarmonyOS工程介绍，在一个APP中，对于同一类型设备有且只有一个Entry Module，其余Module的类型均为Feature。因此，在创建一个类型为Ability的Module时，遵循如下原则：

• 若新增Module的设备类型为已有设备时，则Module的类型将自动设置为“Feature”。
  
• 若新增Module的设备类型为当前还没有创建Module，则Module的类型将自动设置为“Entry”。
    
  

新增Module

• 通过如下两种方法，在工程中添加新的Module。
  
    
  
     
  • 方法1：鼠标移到工程目录顶部，点击鼠标右键，选择New>Module，开始创建新的Module。
       
  • 方法2：在菜单栏选择File > New > Module，开始创建新的Module。
      
      
  
  
• 在New Project Module界面中，选择Module对应的设备类型和模板。
    
  
• 点击Next，在Module配置页面，设置新增Module的基本信息。
  
    
  
     
  • Module类型为Ability或者HarmonyOS Library时，请根据如下内容进行设置，然后点击Next。
    
       
    
         
    • Application/Library name：新增Module所属的类名称。
           
    • Module name：新增模块的名称。
           
    • Module Type：仅Module类型为Ability时存在，工具自动根据设备类型下的模块进行设置。
           
    • Package name：软件包名称，可以点击Edit修改默认包名称，需全局唯一。
           
    • Compatible SDK：兼容的SDK版本。
        
         
    
      
       
  • Module类型为Java Library时，请根据如下内容进行设置，然后点击Finish完成创建。
    
       
    
         
    • Library Name：Java Library类名称。
           
    • Java package name：软件包名称，可以点击Edit修改默认包名称，需全局唯一。
           
    • Java class name：class文件名称。
           
    • Create.gitignore file：是否自动创建.gitignore文件，勾选表示创建。
        
         
    
    
      
      
  
  
• 设置新增Ability或HarmonyOS Library的Page Name。 若该Module类型为Ability，需要设置Visible参数，表示该Ability是否可以被其它应用所调用。
  
    
  
     
  • 勾选（true）：可以被其它应用调用。
       
  • 不勾选（false）：不能被其它应用调用。
      
      
  
  
• 点击Finish，等待创建完成后，可以在工程目录中查看和编辑新增的Module。
    
  

删除Module 为防止开发者在删除Module的过程中，误将其它的模块删除，DevEco Studio提供统一的模块管理功能，需要先在模块管理中，移除对应的模块后，才允许删除。

• 在菜单栏中选择File > Project Structure > Modules，选择需要删除的Module，点击按钮，并在弹出的对话框中点击Yes。
    
  
• 在工程目录中选中该模块，点击鼠标右键，选中Delete，并在弹出的对话框中点击Delete。