欢迎加入开源鸿蒙 PC 社区

欢迎在 PC 社区平台申请新建项目

框架与适配: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 模拟器全屏:移除后缀时三个名称可改、一项冲突,按钮禁用

MateBook Pro 2in1 模拟器全屏:移除后缀时三个名称可改、一项冲突,按钮禁用

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

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

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 模拟器全屏:窄窗中规则在上,原名和目标名仍可对照

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 原生「关于」窗口

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

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

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

MateBook Pro 2in1 模拟器全屏「关于本机」:软件版本和 API

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 × 1920DevEco 自动签名,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

HUAWEI MateBook 14 真机「关于本机」全屏,保留型号、完整软件版本和 API

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

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

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

MateBook 14 真机全屏,实际改名四项,原 cover.txt 保留

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 记录的是签名安装后的预览和实际改名。两处的证据各有用途,复现时可以盯住封面那一行,先看目标列变化,再看执行后的原名列。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐