Android-CircleMenu 使用教程

Android-CircleMenu 使用教程

Android-CircleMenu自定义ViewGroup实现的圆形旋转菜单，支持跟随手指旋转以及快速旋转。项目地址:https://gitcode.com/gh_mirrors/an/Android-CircleMenu

1. 项目目录结构及介绍

在Android-CircleMenu项目中，主要的目录结构如下：

Android-CircleMenu
├── app                // 示例应用程序模块
│   ├── src
│   │   └── main       // 主代码目录
│   │       ├── java    // Java源代码
│   │       └── res     // 资源文件
├── library            // 库模块
│   ├── src
│   │   └── main       // 库源代码
│   │       ├── java    // AndroidCircleMenu库的Java源代码
│   │       └── res     // 库资源
└── ...                 // 其他辅助文件（如README，LICENSE等）

• app 模块包含了示例应用，用于演示如何集成和使用 Android-CircleMenu。
• library 模块包含了 Android-CircleMenu 的核心代码，你需要这个模块来添加自定义视图到你的项目。

2. 项目启动文件介绍

在app/src/main/java/com/example/androidcirclemenu/MainActivity.java中，你可以看到MainActivity作为应用的入口点，它展示了Android-CircleMenu的基本用法。关键部分如下：

public class MainActivity extends AppCompatActivity {
    private CircleMenu circleMenu;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化 CircleMenu
        circleMenu = findViewById(R.id.circle_menu);
        // 设置回调监听器
        circleMenu.setOnItemClickListener(new CircleMenu.OnItemClickListener() {
            @Override
            public void onItemClick(View v, int position) {
                Toast.makeText(MainActivity.this, "Item clicked at position: " + position, Toast.LENGTH_SHORT).show();
            }
        });
        // 添加菜单项
        for (int i = 0; i < 6; i++) {
            circleMenu.addMenuItem(new MenuItem.Builder()
                    .setImageResId(R.drawable.ic_launcher_foreground)
                    .build());
        }

        // 启动动画
        circleMenu.openMenu();
    }
}

MainActivity通过设置布局并初始化CircleMenu对象来展示菜单。菜单项可以通过addMenuItem方法添加，并通过OnItemClickListener监听用户的点击事件。

3. 项目的配置文件介绍

在app/src/main/res下，你会发现AndroidManifest.xml，它是Android应用的主要配置文件。在这个案例中，它包含了一些基本的应用配置，比如应用名称和权限。activity_main.xml是主布局文件，定义了CircleMenu视图及其属性。

<!-- activity_main.xml -->
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <!-- 将 CircleMenu 添加到布局 -->
    <com.example.library.CircleMenu
        android:id="@+id/circle_menu"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        app:cm_item_color="#FF0000"
        app:cm_item_radius="120dp"
        app:cm_open_duration="300"
        app:cm_rotate_duration="1000"
        app:cm_item_image_tint="@color/colorPrimary" />

</androidx.constraintlayout.widget.ConstraintLayout>

布局文件中，CircleMenu的属性如cm_item_color，cm_item_radius等允许你自定义菜单的颜色、半径和其他外观特性。

为了将库添加到你的项目中，你需要在你的build.gradle文件中添加依赖。由于这是第三方库，你应该在你的项目的dependencies块内添加如下代码：

dependencies {
    implementation 'com.example.library:android-circlemenu:版本号'
}

记得替换版本号为你从GitHub项目页面找到的最新版本号。

以上就是Android-CircleMenu项目的基本介绍和配置指南。通过这些步骤，你可以在自己的Android应用中轻松地实现一个旋转的圆形菜单。

Android-CircleMenu自定义ViewGroup实现的圆形旋转菜单，支持跟随手指旋转以及快速旋转。项目地址:https://gitcode.com/gh_mirrors/an/Android-CircleMenu