Home > LIB_Cbb > copy

LIB_Cbb.copy() method

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

复制复用模块

签名

function copy(
	cbbUuid: string,
	libraryUuid: string,
	targetLibraryUuid: string,
	targetClassification?: ILIB_ClassificationIndex | Array<string>,
	newCbbName?: string,
): Promise<string | undefined>;

参数名

参数	类型	描述
cbbUuid	string	复用模块 UUID
libraryUuid	string	库 UUID，可以使用 LIB_LibrariesList 内的接口获取
targetLibraryUuid	string	目标库 UUID
targetClassification	ILIB_ClassificationIndex | Array<string>	（可选） 目标库内的分类
newCbbName	string	（可选） 新复用模块名称，如若目标库内存在重名复用模块将导致复制失败

返回值

Promise<string | undefined>

目标库内新复用模块的 UUID

示例

// 1. 获取系统库与个人库 UUID
const systemLib = await eda.lib_LibrariesList.getSystemLibraryUuid();
const personalLib = await eda.lib_LibrariesList.getPersonalLibraryUuid();

// 2. 从系统库找一个复用模块作为复制来源
const results = await eda.lib_Cbb.search('', systemLib, undefined, 1);
const source = results[0];

// 3. 复制到个人库，指定新名称避免同名冲突（分类传 [] = 不分类）
const newName = `嘉立创示例_复制_${Date.now()}`;
const copiedUuid = await eda.lib_Cbb.copy(source.uuid, systemLib, personalLib, [], newName);

// 创建类保留现场（复制品留在个人库中供观察）

console.log('source:', source.name, source.uuid);
console.log('copiedUuid:', copiedUuid);
console.log('newName:', newName);