Home > DMT_Project > createProject

DMT_Project.createProject() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

创建工程

签名

function createProject(
	projectFriendlyName: string,
	projectName?: string,
	teamUuid?: string,
	folderUuid?: string,
	description?: string,
	collaborationMode?: EDMT_ProjectCollaborationMode,
): Promise<string | undefined>;

参数名

参数	类型	描述
projectFriendlyName	string	工程友好名称
projectName	string	（可选） 工程名称，不可重复，仅支持字母 a-zA-Z、数字 0-9、中划线 -，如若不指定，则根据工程友好名称自动生成
teamUuid	string	（可选） 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团队 UUID
folderUuid	string	（可选） 文件夹 UUID，如若不指定，则为根文件夹
description	string	（可选） 工程描述
collaborationMode	EDMT_ProjectCollaborationMode	（可选） 工程协作模式，如若团队权限无需工程设置协作模式，则该参数将被忽略

返回值

Promise<string | undefined>

工程 UUID，如若为 undefined 则创建失败

示例

// 1. 创建测试工程（友好名带时间戳避免重名，名称与团队留空走默认）
const projectUuid = await eda.dmt_Project.createProject(
	`嘉立创示例_工程 ${Date.now()}`,
	undefined,
	undefined,
	undefined,
	'嘉立创示例：工程创建演示',
);

// 2. 等待工作区同步后回读，确认工程已落地
await new Promise(r => setTimeout(r, 1500));
const brief = await eda.dmt_Project.getProjectInfo(projectUuid);

const folderLabel = !brief?.folderUuid ? '(根目录)' : brief.folderUuid;

console.log('projectUuid:', projectUuid);
console.log('friendlyName:', brief?.friendlyName);
console.log('folderUuid:', folderLabel);