arcview项目招募

// types/ArcType.ce
/// 角度值类型定义（范围：0~360）
export type ANGLE_DEGREE = int;

/// 弧形颜色配置结构体
export struct ArcColorItem {
  color: string;    // 颜色值（如"#CCd0dae4"）
  position: float;  // 渐变位置（0.0~1.0）
}

/// 弧形视图配置结构体
export struct ArcProgressViewConfig {
  isDebug: bool;            // 调试模式开关
  steps: int;               // 进度分段数
  maxAngleDegree: ANGLE_DEGREE; // 最大角度
  curAngleDegree: ANGLE_DEGREE;  // 当前角度
  enableGesture: bool;           // 是否开启手势
  // 尺寸配置（VP单位）
  widthVp: float;
  heightVp: float;
  arcBgStrokeWidthVp: float;
  // 颜色配置
  arcBgColors: Array<ArcColorItem>;
  arcOuterColors: Array<ArcColorItem>;
  // 指示器配置
  enableIndicator: bool;
  arcIndicatorGaugeOptions: IndicatorOptions;
  // 按钮配置
  buttonPlusEnable: bool;
  buttonMinusEnable: bool;
}

// components/ArcProgressView.ce
import core::ArcViewBase;
import core::GestureHandler;
import utils::Logger;
import utils::SizeAdapter;

/// 弧形进度视图组件
@Component
export struct ArcProgressView {
  @Prop config: ArcProgressViewConfig;
  @State curAngle: ANGLE_DEGREE;
  @Link isTouching: bool;

  /// 组件初始化
  build() {
    // 根容器（适配垂直布局）
    Column() {
      // 弧形绘制层
      Canvas() {
        // 绘制背景弧形
        drawArc({
          center: Point(config.widthVp/2, config.heightVp/2),
          radius: config.arcBgWidthVp/2,
          startAngle: 0,
          sweepAngle: config.maxAngleDegree,
          strokeWidth: config.arcBgStrokeWidthVp,
          colors: config.arcBgColors,
          isGradient: true
        });
        // 绘制进度弧形
        drawArc({
          center: Point(config.widthVp/2, config.heightVp/2),
          radius: config.arcInnerWidthVp/2,
          startAngle: 0,
          sweepAngle: this.curAngle,
          strokeWidth: config.arcInnerStrokeWidthVp,
          colors: config.arcInnerColors,
          isGradient: true
        });
        // 绘制指示器
        if (config.enableIndicator) {
          drawIndicator({
            angle: this.curAngle,
            icon: config.arcIndicatorGaugeOptions.icon,
            position: calcIndicatorPosition(this.curAngle, config)
          });
        }
      }
      .width(config.widthVp)
      .height(config.heightVp)
      .gesture(
        // 绑定手势处理（与ScrollView无冲突）
        GestureHandler.buildGesture({
          onPan: (offset: Point) => {
            this.curAngle = calcAngleByGesture(offset, config.maxAngleDegree);
            this.isTouching = true;
            // 角度变化回调（四舍五入）
            this.onAngleDegreeChanged(round(this.curAngle));
          },
          onEnd: () => {
            this.isTouching = false;
          }
        })
      )

      // 自定义按钮组
      Row() {
        if (config.buttonMinusEnable) {
          Button("-")
            .onClick(() => {
              this.curAngle = max(0, this.curAngle - (config.maxAngleDegree/config.steps));
              this.onButtonClicked("minus");
            })
        }
        if (config.buttonPlusEnable) {
          Button("+")
            .onClick(() => {
              this.curAngle = min(config.maxAngleDegree, this.curAngle + (config.maxAngleDegree/config.steps));
              this.onButtonClicked("plus");
            })
        }
      }
    }
    .layout(LayoutMode.AlwaysVertical) // 始终垂直布局
  }

  /// 角度变化回调（需保证参数四舍五入）
  private func onAngleDegreeChanged(newAngle: ANGLE_DEGREE) {
    if (config.isDebug) {
      Logger.info("ArcProgressView", "onAngleDegreeChanged: " + newAngle.toString());
    }
    // 对外暴露的回调触发
    this.config.onAngleDegreeChanged?(newAngle);
  }

  /// 按钮点击回调
  private func onButtonClicked(buttonType: string) {
    if (config.isDebug) {
      Logger.info("ArcProgressView", "onButtonClicked: " + buttonType);
    }
    this.config.onButtonClicked?(buttonType);
  }
}

// utils/SizeAdapter.ce
/// 获取设备显示宽度
export func getDisplayWidth(): float {
  let displayInfo = getHarmonyOSDisplayInfo();
  return displayInfo.width;
}

/// 自定义PP适配逻辑（Pixel Perfect）
export func setCustomPP(adapter: func(px: float, designWidthPx: float) => float) {
  globalPPAdapter = adapter;
}

/// PP单位转换（默认适配设计稿宽度720px）
export func pp(px: float): float {
  let designWidth = 720.0;
  let displayWidth = getDisplayWidth();
  if (globalPPAdapter !== nil) {
    return globalPPAdapter(px, designWidth);
  }
  // 默认适配逻辑：px转VP
  return px / (designWidth / displayWidth);
}