Introducción a la Migración entre Modelos en HarmonyOS

En el desarrollo para HarmonyOS, la transición del modelo FA al modelo Stage implica cambios significativos en las interfaces de API y Contexto. Esto se debe a diferencias en los modelos de hilos y procesos. Las interfaces marcadas con FAModelOnly solo están disponibles en el modelo FA, por lo que al cambiar al modelo Stage, es necesario reemplazarlas con las interfaces correspondientes. A continuación, se analiza un ejemplo práctico de migración para la API startAbility.

Ejemplo de Migración para startAbility

En el modelo FA, se utiliza featureAbility para iniciar habilidades. En el modelo Stage, se accede a través del contexto de UIAbility. Aquí se muestra cómo se adapta el código:

Implementación en el Modelo FA

import { featureAbility } from '@ohos.ability.featureAbility';
import { Want } from '@ohos.app.ability.Want';

const IDENTIFICADOR_LOG: string = 'ComponentePrincipal';

@Entry
@Component
struct PaginaInicio {
  build() {
    Button('Lanzar Habilidad')
      .onClick(async () => {
        try {
          console.info(IDENTIFICADOR_LOG, 'Iniciando proceso de habilidad');
          let datosSolicitud: Want = {
            bundleName: 'ejemplo.aplicacion.modeloFA',
            moduleName: 'moduloBase',
            abilityName: 'ejemplo.aplicacion.modeloFA.HabilidadPagina'
          };
          await featureAbility.startAbility({ want: datosSolicitud });
          console.info(IDENTIFICADOR_LOG, 'Habilidad iniciada exitosamente');
        } catch (excepcion) {
          console.error(IDENTIFICADOR_LOG, 'Error durante el inicio: ' + excepcion);
        }
      })
  }
}

Implementación en el Modelo Stage

import { Want } from '@ohos.app.ability.Want';
import { common } from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';

@Entry
@Component
struct VistaPrincipal {
  private contextoApp = getContext(this) as common.UIAbilityContext;

  build() {
    Button('Ejecutar Habilidad')
      .onClick(() => {
        let parametros: Want = {
          bundleName: "com.ejemplo.miaplicacion",
          abilityName: "HabilidadEntrada"
        };
        this.contextoApp.startAbility(parametros).then(() => {
          console.log('Operación completada con éxito.');
        }).catch((error: BusinessError) => {
          console.error('Fallo en la ejecución: ' + error);
        })
      })
  }
}

Mapeo de Interfaces de Contexto

La migración de interfaces de Contexto entre modelos requiere ajustes específicos. A continuación, se presenta una tabla que describe las equivalencias y cambios necesarios al pasar del modeelo FA al modelo Stage.