鸿蒙 PC 上用 ArkUI 做文件批量改名:先预览,再处理重名
框架与适配:ArkUI 引擎源码
这是一道文件操作的确认题:用户看到预览里有三条可以改,另有一条会撞名,点击提交是否有权改掉前三条?本例把预览当作一次批次确认,先解释每个新名字从哪来,再让用户按完整结果决定是否执行。跟做时可以用示例目录验证冲突处理。
前言
目录里同时放着 cover.txt 和 cover-final.txt。如果把所有文件名里的 -final 去掉,第二个文件会变成 cover.txt。同一批里的笔记、路线和截图文件却都能改。这时按钮应该只改成功的三项,还是让用户先处理封面的冲突?这个鸿蒙 PC 练习选了后者。预览里的所有变更作为一批,用户看到哪条冲突、改了规则之后会得到什么名字,再决定是否执行。
做界面时看的是 Microsoft PowerToys 的 PowerRename。它把原名和改完的名字放在一起,输入规则后直接看右边。ArkUI 工程里保留了这个对照方式,把状态放到同一行。列表下面一直显示可改名的数量、待处理的数量和操作结果,核对完可以直接提交。PowerRename 界面参考
三个可以改,为什么按钮是灰的
第一次打开文件改名台,会在应用目录里建立五个小文本文件。输入框默认查找 -final,替换框留空。看封面这一行,cover-final.txt 的目标和上一行已有的 cover.txt 一样。列表标出「名称冲突」,下面仍把可改的三项算出来,便于用户判断改规则会影响多少文件。鸿蒙 PC 模拟器里这时「应用改名」显示为不可用,文件列表仍是初始的五个名字。

MateBook Pro 2in1 模拟器全屏:移除后缀时三个名称可改、一项冲突,按钮禁用
点「改为归档」,替换框变成 -archive。预览里出现 cover-archive.txt,原先的 cover.txt 仍显示「保留」。其他三个文件同样变成 -archive.txt,这时才可以应用。点完后,原名一列也变成归档后的名字,底部显示「已改名 4 个文件」。RenameDesk 日志里可以对到 rename_applied count=4。ArkUI 列表重新读取了目录,所以还会用原规则再算一次,得到「0 项可改名」。这正好区分了「目标列已经变了」和「目录中的名字已经变了」。

MateBook Pro 2in1 模拟器全屏:四个文件完成改名,cover.txt 保留

模拟器录屏:切换归档规则、缩窄再拉宽窗口、应用改名
这段 GIF 取自模拟器窗口的实录。缩窄、拉宽两段的有效帧率分别约为 13 和 14 fps。
预览怎样判断是重名
ArkUI 的两个输入框都调 calculate()。它先按最后一个点把文件名拆成主体和扩展名,再替换主体里首次匹配的那段文字。用回调返回替换文字,是为了让用户输入的 $ 按字面参与替换,避免被 JavaScript 的替换字符串语法解释。扩展名仍从原名字拼回去,留空只是去掉匹配的那段主体。
计算时用一张表数目标名字出现的次数,同时把原目录里的名字放进一个集合。两个源文件算出同一个目标,或目标已经被原目录中的某个名字占住,当前行都会标冲突。示例将名字转成小写后比较,目的是把可能只差大小写的名字也拦下来。这条规则比实际文件系统可能更严格。如果要支持大小写专用改名,或者 A → B、B → C 这种链式改名,需要另外设计临时文件名和执行顺序。这个鸿蒙 PC 练习中,保守拦下这些情况可以让预览和执行顺序保持简单。
点击应用时会重新读目录和计算预览,逐项改名之前还会用 accessSync 检查目标路径。已经改过的条目记在 done 里,遇到异常就尝试按逆序恢复。如果恢复途中再次报错,界面会提示检查列表。同步调用限制在五个演示文件内,本轮只复测了重名拦截和正常改名,没有注入磁盘故障。把这个 ArkUI 示例扩展到任意用户目录前,还需要处理权限、并发写入,以及批量工作对界面响应的影响。Core File Kit 文件接口
把窗口缩窄,再看看原名与目标名
宽窗里,规则和预览左右放。宽度低于 720 vp 时,规则移到上面,预览取得一整行的空间,文件名仍然左右对照。这个阈值用 ArkUI 根组件的 onAreaChange 获得,跟鸿蒙 PC 的屏幕像素数无关。长列表由外层 Scroll 承接,窄窗可以滚到操作区。复现时先点归档,再拖动窗口边缘,能看到预览结果跟着布局走,拉宽后仍然是四项可改名。

MateBook Pro 2in1 模拟器全屏:窄窗中规则在上,原名和目标名仍可对照
用同一个初始目录复现
| 环境 | 版本或配置 |
|---|---|
| Windows 开发机 | DevEco Studio 6.1.1.300,SDK 包 6.1.1.125 |
| 鸿蒙 PC 模拟器 | DevEco MateBook Pro 2in1,3120 × 2080,x86_64。模拟器软件版本 6.1.0.125(SP12DEVC00E47R1P3),API 6.1.1(24) |
| 工程 | ArkUI、ArkTS、Stage 模型,deviceTypes: ["2in1"],目标和最低兼容 API 24,应用版本 1.0.0 |

Windows 开发机上 DevEco Studio 原生「关于」窗口

DevEco Studio 实际工程编辑区:入口模块的 2in1 设备声明

MateBook Pro 2in1 模拟器全屏「关于本机」:软件版本和 API
同一条改名规则,换到 MateBook 14 再走一遍
| 运行环境 | 设备和版本 | 这次验到哪一步 |
|---|---|---|
| 鸿蒙 PC 真机 | HUAWEI MateBook 14(MNTXM-24B),HarmonyOS 7.0.0,软件版本 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64,2880 × 1920 | DevEco 自动签名,USB 安装并启动 1.0.0;重名时禁用执行,改规则后实际改名四项 |
| 鸿蒙 PC 模拟器 | MateBook Pro 2in1,HarmonyOS 6.1.0,软件版本 6.1.0.125(SP12DEVC00E47R1P3),API 6.1.1(24),x86_64 | 未签名调试包、窄窗布局、预览与改名;上文 GIF 录自模拟器 |

HUAWEI MateBook 14 真机「关于本机」全屏,保留型号、完整软件版本和 API
在 USB 真机上,我先确认还是那五个初始文件。封面的目标名碰到了已有的 cover.txt,底部写着三项可改、一项待处理,执行按钮呈禁用。点「改为归档」时,先只看目标列,确认原名列还没变。执行后再比一次,四条原名都变成 -archive.txt,原有的封面保持原名。这个对照可以区分预览算出了计划和目录已经写入。

MateBook 14 真机全屏,封面重名挡住整批操作,执行按钮禁用

MateBook 14 真机全屏,实际改名四项,原 cover.txt 保留
本次给当前包名生成了 DevEco 调试签名。构建后选 entry-default-signed.hap,用 HDC 指定 USB 真机安装。启动以后核对已装版本,再取本次点击对应的 HiLog。以下保留日志中的关键字段。
hvigor Finished :entry:default@SignHap
install bundle successfully.
start ability successfully.
versionName: 1.0.0
versionCode: 1000000
RenameDesk: rename_applied count=4
用 DevEco Studio 新建 ArkTS Empty Ability 工程,把目标设备设为 2in1。入口 EntryAbility 加载 pages/Index,在页面列表 main_pages.json 中也填这一项。应用和入口的显示名称都用「文件改名台」,启动背景色用 #F6F7FB。模拟器这轮允许安装未签名调试包;真机使用 DevEco 自动签名生成的调试 HAP,设备与包名均须对上。鸿蒙电脑应用开发入门
要重做第一轮,清除这个示例应用的数据后再启动。应用只在演示目录缺失时创建初始文件。正常退出再启动,会保留上次写入目录的名称,重复选择 -final 就不会再匹配已归档的文件。下面的 ArkUI 页面代码包含样例生成、预览和落盘三个步骤。
实际踩到的问题:按钮看得见,录屏里却没点上
第一次重录时,启动命令已经返回成功,录制开始后却有一段白色启动页。那次使用固定坐标发出的第一下点击落在页面加载前,录像里始终显示原来的冲突预览,HiLog 只有 desk_ready。另一次从系统设置切回应用,窗口位置已经变了,沿用旧坐标又点偏了。最后先等应用加载,从当前布局里读 rename-archive 和 rename-apply 的边界,再用模拟器输入命令点各自中心。录完同时查列表和 rename_applied count=4,才确认录像确实记录了改名。
FAQ
为什么重新打开后看不到五个初始名字? 安装覆盖或重启应用会保留演示目录。已复测重启后仍能读到四个 -archive.txt。想重走冲突流程,可以在测试模拟器里清除这个应用的数据后再打开。
替换框留空会改扩展名吗? 不会。代码先分离最后一个扩展名,只替换主体里的第一处匹配。比如 notes-final.txt 会变成 notes.txt,.txt 保留。
看到名称冲突后,能先改另外三项吗? 这一版的应用按钮要求整批无冲突。把替换词改成 -archive 后,四条计划都能执行,原有的 cover.txt 保持原名。
工程配置和核心文件
build-profile.json5
{
"app": {
"signingConfigs": [],
"products": [
{
"name": "default",
"targetSdkVersion": "6.1.1(24)",
"compatibleSdkVersion": "6.1.1(24)",
"runtimeOS": "HarmonyOS"
}
],
"buildModeSet": [{ "name": "debug" }, { "name": "release" }]
},
"modules": [
{
"name": "entry",
"srcPath": "./entry",
"targets": [{ "name": "default", "applyToProducts": ["default"] }]
}
]
}
AppScope/app.json5
{
"app": {
"bundleName": "com.aasd23.ugcrenamepreview",
"vendor": "UGC Lab",
"versionCode": 1000000,
"versionName": "1.0.0",
"icon": "$media:layered_image",
"label": "$string:app_name"
}
}
entry/src/main/module.json5
{
"module": {
"name": "entry",
"type": "entry",
"mainElement": "EntryAbility",
"deviceTypes": ["2in1"],
"deliveryWithInstall": true,
"installationFree": false,
"pages": "$profile:main_pages",
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ets",
"icon": "$media:layered_image",
"label": "$string:entry_label",
"startWindowIcon": "$media:foreground",
"startWindowBackground": "$color:startup",
"exported": true,
"skills": [{ "entities": ["entity.system.home"], "actions": ["action.system.home"] }]
}
]
}
}
entry/src/main/ets/entryability/EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class EntryAbility extends UIAbility {
onWindowStageCreate(stage: window.WindowStage): void {
stage.loadContent('pages/Index').then(() => {
hilog.info(0x0412, 'RenameDesk', 'desk_ready');
}).catch((error: BusinessError) => {
hilog.error(0x0412, 'RenameDesk', 'load_error code=%{public}d', error.code);
});
}
}
entry/src/main/ets/pages/Index.ets
import { common } from '@kit.AbilityKit';
import { fileIo } from '@kit.CoreFileKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
interface RenameRow {
before: string;
after: string;
state: string;
}
const SAMPLE: string[] = ['cover.txt', 'cover-final.txt', 'notes-final.txt', 'route-final.txt', 'shot-final.txt'];
const BACKGROUND = '#EAF0F4';
const INK = '#142B35';
const MUTED = '#526871';
const ACCENT = '#006F66';
@Entry
@Component
struct Index {
@State private compact: boolean = false;
@State private names: string[] = [];
@State private search: string = '-final';
@State private replacement: string = '';
@State private message: string = '';
@State private changed: number = 0;
@State private conflicts: number = 0;
@State private rows: RenameRow[] = [];
private directory: string = '';
aboutToAppear(): void {
const context = this.getUIContext().getHostContext() as common.UIAbilityContext;
this.directory = `${context.filesDir}/rename-desk`;
try {
if (!fileIo.accessSync(this.directory)) {
fileIo.mkdirSync(this.directory);
SAMPLE.forEach((name: string) => this.createSample(name));
}
this.refresh();
} catch {
this.message = '无法打开演示目录';
}
}
private createSample(name: string): void {
const file = fileIo.openSync(`${this.directory}/${name}`, fileIo.OpenMode.CREATE | fileIo.OpenMode.WRITE_ONLY);
try {
fileIo.writeSync(file.fd, `Rename Desk sample: ${name}\n`);
} finally {
fileIo.closeSync(file);
}
}
private refresh(): void {
this.names = fileIo.listFileSync(this.directory).sort();
this.calculate();
}
private calculate(): void {
const source = new Set<string>(this.names.map((name: string) => name.toLowerCase()));
const proposed = new Map<string, number>();
const plan = this.names.map((name: string): RenameRow => {
const dot = name.lastIndexOf('.');
const stem = dot > 0 ? name.slice(0, dot) : name;
const extension = dot > 0 ? name.slice(dot) : '';
const next = this.search ? stem.replace(this.search, (): string => this.replacement) + extension : name;
const key = next.toLowerCase();
proposed.set(key, (proposed.get(key) ?? 0) + 1);
return { before: name, after: next, state: name === next ? '保留' : '待改名' };
});
this.changed = 0;
this.conflicts = 0;
plan.forEach((row: RenameRow) => {
if (row.state === '保留') {
return;
}
const key = row.after.toLowerCase();
if (row.after.startsWith('.') || /[\\/:*?"<>|]/.test(row.after) || row.after.length > 180) {
row.state = '名称无效';
} else if ((proposed.get(key) ?? 0) > 1 || source.has(key)) {
row.state = '名称冲突';
}
if (row.state === '待改名') {
this.changed++;
} else {
this.conflicts++;
}
});
this.rows = plan;
}
private rule(value: string): void {
this.search = '-final';
this.replacement = value;
this.message = '';
this.calculate();
}
private apply(): void {
this.refresh();
if (this.conflicts > 0 || this.changed === 0) {
this.message = '请先检查预览';
return;
}
const done: RenameRow[] = [];
try {
this.rows.filter((row: RenameRow) => row.state === '待改名').forEach((row: RenameRow) => {
const destination = `${this.directory}/${row.after}`;
if (fileIo.accessSync(destination)) {
throw new Error('Destination exists');
}
fileIo.renameSync(`${this.directory}/${row.before}`, destination);
done.push(row);
});
this.message = `已改名 ${done.length} 个文件`;
hilog.info(0x0412, 'RenameDesk', 'rename_applied count=%{public}d', done.length);
} catch {
let restored = true;
done.reverse().forEach((row: RenameRow) => {
try {
fileIo.renameSync(`${this.directory}/${row.after}`, `${this.directory}/${row.before}`);
} catch {
restored = false;
}
});
this.message = restored ? '改名失败,已恢复本轮变更' : '恢复未完成,请检查列表';
}
this.refresh();
}
@Builder
private RulePanel() {
Column({ space: 14 }) {
Text('替换规则').fontSize(20).fontWeight(FontWeight.Bold).fontColor(INK).width('100%')
Column({ space: 6 }) {
Text('查找').fontSize(13).fontColor(MUTED).width('100%')
TextInput({ text: this.search, placeholder: '输入原文件名中的文本' }).id('rename-search')
.fontSize(15).height(40).backgroundColor('#EBF1F2')
.onChange((value: string) => { this.search = value; this.message = ''; this.calculate(); })
}.width('100%')
Column({ space: 6 }) {
Text('替换为').fontSize(13).fontColor(MUTED).width('100%')
TextInput({ text: this.replacement, placeholder: '留空则移除' }).id('rename-replacement')
.fontSize(15).height(40).backgroundColor('#EBF1F2')
.onChange((value: string) => { this.replacement = value; this.message = ''; this.calculate(); })
}.width('100%')
Flex({ wrap: FlexWrap.Wrap }) {
Button('移除后缀', { type: ButtonType.Normal }).id('rename-remove').height(36)
.margin({ right: 8, bottom: 6 }).borderRadius(8).backgroundColor('#E5EFEE').fontColor(ACCENT)
.onClick(() => this.rule(''))
Button('改为归档', { type: ButtonType.Normal }).id('rename-archive').height(36)
.margin({ bottom: 6 }).borderRadius(8).backgroundColor('#E5EFEE').fontColor(ACCENT)
.onClick(() => this.rule('-archive'))
}.width('100%')
Text('只改文件名主体,保留扩展名。').width('100%').fontSize(13).fontColor(MUTED)
}.width(this.compact ? '100%' : 270).padding(20).borderRadius(18).backgroundColor('#FFFFFF')
}
@Builder
private PreviewPanel() {
Column({ space: 10 }) {
Text('改名前后').width('100%').fontSize(20).fontWeight(FontWeight.Bold).fontColor(INK)
Row() {
Text('原名称').layoutWeight(1).fontSize(13).fontColor(MUTED)
Text('目标名称').layoutWeight(1).fontSize(13).fontColor(MUTED)
Text('状态').width(this.compact ? 64 : 84).fontSize(13).fontColor(MUTED)
}.width('100%').padding({ top: 8, bottom: 3 })
ForEach(this.rows, (row: RenameRow) => {
Row({ space: 5 }) {
Text(row.before).layoutWeight(1).fontSize(14).fontColor(INK)
Text(row.after).layoutWeight(1).fontSize(14).fontColor(row.state === '保留' ? MUTED : INK)
.fontWeight(row.state === '保留' ? FontWeight.Normal : FontWeight.Medium)
Text(row.state).width(this.compact ? 64 : 84).fontSize(12)
.fontColor(row.state === '待改名' ? ACCENT : row.state === '保留' ? MUTED : '#A43127')
}.width('100%').constraintSize({ minHeight: 38 })
Divider().color('#E1E9EC')
}, (row: RenameRow) => `${row.before}:${row.after}:${row.state}`)
}.padding(20).borderRadius(18).backgroundColor('#FFFFFF').width('100%')
}
build() {
Scroll() {
Column({ space: 17 }) {
Column({ space: 10 }) {
Text('文件改名台').fontSize(this.compact ? 31 : 38).fontWeight(FontWeight.Bold).fontColor('#FFFFFF')
.width('100%')
Text('替换一段名称,先检查哪些文件会变。').fontSize(15).fontColor('#D0E6E7').width('100%')
}.width('100%').padding(this.compact ? 22 : 27).borderRadius(19).backgroundColor('#153944')
if (this.compact) {
this.RulePanel()
this.PreviewPanel()
} else {
Row({ space: 17 }) {
this.RulePanel()
Column() { this.PreviewPanel() }.layoutWeight(1)
}.width('100%').alignItems(VerticalAlign.Top)
}
Flex({ wrap: FlexWrap.Wrap, alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceBetween }) {
Column({ space: 4 }) {
Text(`${this.names.length} 个文件 · ${this.changed} 项可改名 · ${this.conflicts} 项待处理`).id('rename-count')
.fontSize(14).fontColor(this.conflicts > 0 ? '#A43127' : ACCENT).fontWeight(FontWeight.Medium)
Text(this.message || '操作范围:应用演示目录').id('rename-result').fontSize(13).fontColor(MUTED)
}.alignItems(HorizontalAlign.Start).margin({ right: 10, bottom: 6 })
Button('应用改名', { type: ButtonType.Normal }).id('rename-apply').height(42).borderRadius(9)
.enabled(this.changed > 0 && this.conflicts === 0)
.backgroundColor(this.changed > 0 && this.conflicts === 0 ? ACCENT : '#687C82').fontColor('#FFFFFF')
.onClick(() => this.apply())
}.padding({ left: 15, right: 15, top: 12, bottom: 8 }).width('100%')
}.padding(this.compact ? 16 : 25).width('100%').constraintSize({ maxWidth: 1210 })
}.width('100%').height('100%').align(Alignment.Top).backgroundColor(BACKGROUND)
.onAreaChange((_: Area, area: Area) => { this.compact = Number(area.width) < 720; })
}
}
总结
MateBook 14 和模拟器都复现了同一条业务规则。移除 -final 时,已有的 cover.txt 会挡住整批操作。替换成 -archive 后,四个文件实际改名,原有封面保留。窄窗动图记录的是模拟器,真机全屏图和 HiLog 记录的是签名安装后的预览和实际改名。两处的证据各有用途,复现时可以盯住封面那一行,先看目标列变化,再看执行后的原名列。
更多推荐



所有评论(0)