鸿蒙ArkUI【开发移植Carbon】

news2024/11/20 15:19:49

项目介绍

本项目是基于开源项目[Carbon] 进行harmonyos化的移植和开发的。

移植版本：Branches/master

这不是单纯只是API和基本功能展示demo，它是最有用的自定义控件的实现，如设计规范中所示。
Carbon试图：

让事情变得更简单（指定cornerRadius=‘dp’ 而不是创建一个xml 和/或一个ViewOutlineProvider）
使其全部工作并在所有 API 上看起来都相同（例如 CheckBox 的左填充）
真正向后移植功能（不要对阴影使用渐变！）

项目名称：Carbon

所属系列：harmonyos的第三方组件适配移植

功能：一个适用于鸿蒙的自定义组件框架，帮助快速实现各种需要的效果

项目移植状态：大部分移植

调用差异：基本没有使用差异，可以参照单元测试或原项目api进行使用

支持功能

支持自定义progressBar功能
支持自定义RoundProgressBar功能
支持Button不同点击效果功能
支持自定义SeekBar滑动功能
支持各种动画效果展示
支持添加收藏组件，快速查找
支持各种列表展示(包含头像，文字等)功能
支持展示控件代码功能
支持不同Dialog效果展示
以及其它自定义效果/控件

安装教程

方案一

可以先下载项目，将项目中的carbon库提取出来放在所需项目中通过build配置

dependencies {
     implementation project(":carbon")
}

方案二

1.项目根目录的build.gradle中的repositories添加：

    buildscript {
       repositories {
           ...
           mavenCentral()
       }
       ...
   }
   
   allprojects {
       repositories {
           ...
           mavenCentral()
       }
   }

2.开发者在自己的项目中添加依赖

dependencies {
    implementation 'com.gitee.ts_ohos:carbon:1.0.0'
}

使用说明

1.权限

需要网络权限:
“name”: “ohos.permission.INTERNET”

2.代码使用

            打开不同的设置页面：  
            often_text.setClickedListener(component -> {
                Intent intent = new Intent();
                if (often_text.getText().equals("Widget animations")) {
                    present(new WidgetAnimationsSlice(), intent);
                } else if (often_text.getText().equals("Image fade")) {
                    present(new ImageFadeSlice(), intent);
                } else if (often_text.getText().equals("Touch ripple")) {
                    present(new TouchRippleSlice(), intent);
                } else if (often_text.getText().equals("Path animation")) {
                    present(new PathAnimationSlice(), intent);
                }
...

        // BORDERLESS 触摸事件监听器(按下/抬起)（three）
        btnBorderless.setTouchEventListener(new Component.TouchEventListener() {
            @Override
            public boolean onTouchEvent(Component component, TouchEvent touchEvent) {
                int action = touchEvent.getAction();
                switch (action) {
                    case TouchEvent.PRIMARY_POINT_DOWN:
                        imageView.setVisibility(Component.VISIBLE);
                        break;
                    case TouchEvent.CANCEL:
                    case TouchEvent.PRIMARY_POINT_UP:
                        imageView.setVisibility(Component.HIDE);
                        break;
                }
                return true;
            }
        });

        //对每个条目判断是否收藏：
        mList.add(new DataBean(null, "The most popular problem solutions and other fun ideas implemented with Carbon's widgets and features", null, null));
        mList.add(new DataBean(power, "Power Menu", null, preferences.getBoolean("Power Menu", false) ? starFavour : favour));
        mList.add(new DataBean(null, "Auto Complete", element, preferences.getBoolean("Auto Complete", false) ? starFavour : favour));
        mList.add(new DataBean(null, "Quick Return", null, preferences.getBoolean("Quick Return", false) ? starFavour : favour));
        mList.add(new DataBean(search, "Search Toolbar", null, preferences.getBoolean("Search Toolbar", false) ? starFavour : favour));
        mList.add(new DataBean(parse1, "Share toolbar", element, preferences.getBoolean("Share toolbar", false) ? starFavour : favour));
        mList.add(new DataBean(person, "Profile", null, preferences.getBoolean("Profile", false) ? starFavour : favour));
        mList.add(new DataBean(player, "Music player", element, preferences.getBoolean("Music player", false) ? starFavour : favour));
        mList.add(new DataBean(null, "Collapsing toolbar", null, preferences.getBoolean("Collapsing toolbar", false) ? starFavour : favour));