可可图片编辑 HarmonyOS 上架应用分享

状态管理策略

项目全面采用 HarmonyOS V2 状态管理方案，相比 V1 版本具有更好的性能和更简洁的 API：

@Entry
@Route({ name: 'CompressionPage', useTemplate: true })
@ComponentV2
export struct CompressionPage {
  @Local selectedImage: ImageInfo | null = null;
  @Local compressionParams: CompressionParams = {
    quality: 80,
    scale: 1.0,
    format: ImageFormat.JPEG,
    type: CompressionType.QUALITY,
    mode: CompressionMode.MANUAL,
    keepAspectRatio: true
  };
  @Local compressionResult: CompressionResult | null = null;
  @Local operationState: OperationState = OperationState.IDLE;
}

智能图片压缩算法

图片压缩是应用的核心功能之一，我们实现了一套智能压缩算法，支持三种压缩模式。

压缩参数接口设计

export interface CompressionParams {
  quality: number; // 压缩质量 (0-100)
  scale: number; // 缩放比例 (0.1-1.0)
  format: ImageFormat; // 目标格式
  type: CompressionType; // 压缩类型
  mode: CompressionMode; // 压缩模式
  keepAspectRatio: boolean; // 是否保持宽高比
  maxFileSize?: number; // 最大文件大小 (KB)
  maxWidth?: number; // 最大宽度
  maxHeight?: number; // 最大高度
}

自适应压缩算法

针对按文件大小压缩的需求，我们实现了基于二分查找的自适应压缩算法：

export async function compressImageBySize(imageUri: string, params: CompressionParams): Promise<CompressionResult> {
  const targetSize = (params.maxFileSize || 1024) * 1024; // 转换为字节
  let minQuality = 10;
  let maxQuality = params.quality;
  while (maxQuality - minQuality > 5) {
    const currentQuality = Math.floor((minQuality + maxQuality) / 2);
    const compressedData = await compressWithQuality(imageUri, currentQuality);
    if (compressedData.byteLength <= targetSize) {
      minQuality = currentQuality;
    } else {
      maxQuality = currentQuality;
    }
  }
  return bestResult;
}