Home > SYS_FileManager > getDeviceFileByDeviceUuid

SYS_FileManager.getDeviceFileByDeviceUuid() method

使用器件 UUID 获取器件文件

签名

function getDeviceFileByDeviceUuid(
	deviceUuid: string | Array<string>,
	libraryUuid?: string,
	fileType?: 'elibz' | 'elibz2',
): Promise<File | undefined>;

参数名

参数	类型	描述
deviceUuid	string | Array<string>	器件 UUID 或器件 UUID 列表
libraryUuid	string	（可选） 库 UUID，可以使用 LIB_LibrariesList 内的接口获取，如若不传入，则为系统库
fileType	'elibz' | 'elibz2'	(Optional)

返回值

Promise<File | undefined>

器件文件数据，undefined 表示数据获取失败

备注

可以使用 SYS_FileSystem.saveFile() 接口将文件导出到本地文件系统

注意：本接口需要启用 **团队库 > 下载库** 权限，没有权限调用将始终 throw Error

示例

// 1. 按立创编号精确搜索系统库器件，取第一个的 UUID
const deviceList = await eda.lib_Device.searchByProperties({ supplierId: 'C1523' }, undefined, undefined, undefined, 5, 1);
const device = deviceList[0];

// 2. 按器件 UUID 获取器件文件
const deviceFile = await eda.sys_FileManager.getDeviceFileByDeviceUuid(device.uuid);

// 3. 输出器件与文件信息（size 单位为字节）
console.log('器件名：', device.name);
console.log('文件名：', deviceFile.name);
console.log('文件大小：', deviceFile.size);