目录

使用TaskPool在子线程使用AES加密

问题现象

开发者希望在子线程(TaskPool)中执行AES加密操作,但遇到以下问题:

背景知识

解决方案

  1. 在并发函数中使用自定义类或函数时,需将其定义在单独的文件中,否则可能被视为闭包。加解密逻辑拆分为独立文件,确保所有对象可序列化。
    // utils/Func.ets
    import { cryptoFramework } from '@kit.CryptoArchitectureKit';
    import { buffer } from '@kit.ArkTS';
    
    export function genIvParamsSpec() {
      let ivBlob: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from('0123456789101112', 'utf-8').buffer) };
      let ivParamsSpec: cryptoFramework.IvParamsSpec = {
        algName: 'IvParamsSpec',
        iv: ivBlob
      };
      return ivParamsSpec;
    }
    
    function genkey() {
      // 子线程内生成密钥(避免传递非Sendable对象)
      let symKeyGenerator = cryptoFramework.createSymKeyGenerator('AES256');
      return symKeyGenerator.generateSymKeySync();
    }
    
    export const key: cryptoFramework.SymKey = genkey();
    
    export const CIPHER_TRANSFORMATION = 'AES256|CBC|PKCS7';
  2. 通过TaskPool分发任务,主函数调用并发函数并获取结果。
    // Index.ets
    import { taskpool } from '@kit.ArkTS';
    import { cryptoFramework } from '@kit.CryptoArchitectureKit';
    import { genIvParamsSpec, key, CIPHER_TRANSFORMATION } from '../utils/Func';
    
    // 步骤1:定义并发函数(内部创建加密对象)
    @Concurrent
    function aesEncrypt(src: Uint8Array): Uint8Array {
      let cipher = cryptoFramework.createCipher(CIPHER_TRANSFORMATION);
      const iv = genIvParamsSpec();
      cipher.initSync(cryptoFramework.CryptoMode.ENCRYPT_MODE, key, iv);
      const plaintext: cryptoFramework.DataBlob = { data: src };
      return cipher.doFinalSync(plaintext).data;
    }
    
    // 步骤2:主线程调用taskpool
    async function startEncryption() {
      let task = new taskpool.Task(aesEncrypt, new Uint8Array([0x01, 0x02])); // 传递原始数据
      let encryptedData = await taskpool.execute(task) as Uint8Array;
      console.info('Encryption succeeded:', encryptedData.toString());
    }
    
    @Entry
    @Component
    struct Index {
      build() {
        RelativeContainer() {
          Button('AES加密')
            .fontSize($r('app.float.page_text_font_size'))
            .fontWeight(FontWeight.Bold)
            .onClick(() => {
              startEncryption();
            });
        }
        .height('100%')
        .width('100%');
      }
    }