HarmonyOS 鸿蒙Next中调用截图createFromBuilder接口报错TypeError: Cannot read property observeComponentCreation2 of undefined

【问题定位】

createFromBuilder在进行离屏截图时，不支持传入全局builer，在文档已有相关说明，详见Class (ComponentSnapshot)。

【解决方案】

如果希望正确截图，可以将上述示例中的全局函数放到自定义组件内部，代码如下。

import { image } from '@kit.ImageKit';
import { UIContext } from '@kit.ArkUI';

@Entry
@Component
struct ComponentSnapshotExample {
  @State pixmap: image.PixelMap | undefined = undefined;
  uiContext: UIContext = this.getUIContext();

  @Builder
  RandomBuilder() {
    Flex({ direction: FlexDirection.Column, justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
      Text('Test menu item 1')
        .fontSize(20)
        .width(100)
        .height(50)
        .textAlign(TextAlign.Center)
      Divider().height(10)
      Text('Test menu item 2')
        .fontSize(20)
        .width(100)
        .height(50)
        .textAlign(TextAlign.Center)
    }
    .width(100)
    .id("builder")
  }

  async buildMarkerSnapshot(uiContext: UIContext | undefined): Promise<image.PixelMap | undefined> {
    try {
      const snapshot = uiContext?.getComponentSnapshot().createFromBuilder(
        () => {
          this.RandomBuilder()
        },
      )
      return snapshot;
    } catch (e) {
      const err = e as Record<string, Object>
      const code = err.code
      const message = err.message
      return undefined
    }
  }

  build() {
    Column() {
      Button("click to generate UI snapshot")
        .onClick(async () => {
          this.pixmap = await this.buildMarkerSnapshot(this.uiContext)
        })
      Image(this.pixmap)
        .margin(10)
        .height(200)
        .width(200)
        .border({ color: Color.Black, width: 2 })
    }.width('100%').margin({ left: 10, top: 5, bottom: 5 }).height(300)
  }
}

此时运行代码，可以成功截图。

该错误提示observeComponentCreation2未定义，表明调用createFromBuilder时传入的Builder对象不完整或API已变更。在HarmonyOS Next中，截图接口需从@ohos.multimedia.screenshot导入，并通过createWindowBuilder或createComponentBuilder正确构建Builder实例。确认Builder已调用observeComponentCreation2方法或改用新的createAsync接口传递组件实例。请使用最新SDK并核对API签名。