FlutteringLayout 项目启动与配置教程

1. 项目目录结构及介绍

FlutteringLayout 是一个用于实现直播间点赞桃心飘动效果的开源控件。以下是项目的目录结构及其简要介绍：

• app/：存放项目的主要应用程序代码，包括Activity、Fragment、自定义View等。
• gradle/：包含项目的Gradle构建配置文件。
• lib/：存放项目的核心库代码，包括FlutteringLayout的实现。
• .circleci/：存放持续集成配置文件。
• .gitignore：指定Git忽略的文件和目录。
• GIF.gif：项目效果展示的GIF图。
• LICENSE：项目使用的Apache-2.0许可证文件。
• README.md：项目的说明文档。
• build.gradle：项目的Gradle构建脚本。
• gradlew 和 gradlew.bat：用于在命令行中执行Gradle任务的脚本文件。
• settings.gradle：Gradle的设置文件，用于配置项目。
• versions.gradle：用于管理项目依赖版本号的配置文件。

2. 项目的启动文件介绍

项目的启动文件主要是 app 目录下的 MainActivity.java 文件，这是应用程序的入口点。以下是启动文件的基本结构：

package com.king.view.flutteringlayout;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 初始化FlutteringLayout控件，并添加桃心效果
        FlutteringLayout flutteringLayout = findViewById(R.id flutteringLayout);
        flutteringLayout.addHeart();
    }
}

在 onCreate 方法中，会设置应用程序的布局，并初始化 FlutteringLayout 控件，然后调用 addHeart() 方法添加桃心飘动效果。

3. 项目的配置文件介绍

项目的配置文件主要是 build.gradle 文件，包括项目级和模块级的配置。

• 项目级 build.gradle：定义了项目整体的构建逻辑，如支持的Gradle版本、项目依赖的仓库和全局依赖等。

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.1.0"
        // 其他依赖
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

• 模块级 build.gradle：定义了特定模块的构建逻辑，如应用的编译选项、依赖管理等。

plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 29
    defaultConfig {
        applicationId "com.king.view.flutteringlayout"
        minSdkVersion 15
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.github.jenly1314:FlutteringLayout:1.1.1'
    // 其他依赖
}

在模块级的 build.gradle 文件中，我们指定了应用的编译选项，包括编译SDK版本、最小和目标SDK版本、应用ID、版本号等。同时，我们还添加了项目的依赖项，如 FlutteringLayout 控件的依赖。