FloatWindow 使用与集成指南

1. 项目目录结构及介绍

在 FloatWindow 项目中，主要的目录结构包括以下几个部分：

FloatWindow/
├── app/                // 示例应用程序模块
│   ├── src/
│   │   ├── main/       // 主代码目录
│   │   │   ├── java/   // Java代码
│   │   │   └── res/    // 资源文件
├── library/            // FloatWindow 模块
│   ├── src/
│   │   ├── main/       // 演示FloatWindow库的核心代码
│   ├── build.gradle     // 库模块的构建脚本
└── README.md           // 项目简介和使用说明

library 模块包含了 FloatWindow 的核心功能实现，app 模块则是一个简单的示例应用，用于演示如何将该库集成并使用。

2. 项目的启动文件介绍

项目中的启动文件主要位于 app/src/main/java/com/example/floatwindow 目录下。例如：

• MainActivity.java: 这是示例应用的主要Activity，通常在这里创建和管理悬浮窗实例。它展示了如何初始化 FloatWindow 并处理相关事件。

public class MainActivity extends AppCompatActivity {
    private FloatWindow floatWindow;

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

        // 初始化 FloatWindow
        floatWindow = FloatWindow.with(this)
                .setView(LayoutInflater.from(this).inflate(R.layout.float_view, null))
                .setTag("my_float_window")
                .build();

        // 显示悬浮窗
        floatWindow.show();
    }

    // ...其他方法，如处理悬浮窗的显示、隐藏和销毁等
}

在这个例子中，MainActivity 创建了一个 FloatWindow 实例并展示了如何设置视图内容、标签并调用 build() 方法准备实例。然后通过 show() 方法显示悬浮窗。

3. 项目的配置文件介绍

AndroidManifest.xml

在 app/src/main/AndroidManifest.xml 文件中，需要添加必要的权限，以允许应用显示悬浮窗：

<manifest>
    ...
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
    ...
</manifest>

SYSTEM_ALERT_WINDOW 权限使得应用可以在所有其他应用之上显示内容，这是实现悬浮窗的关键。

build.gradle 文件

在 app/build.gradle 和 library/build.gradle 中，你需要确保依赖关系正确设置，以便能使用 FloatWindow 库：

// app/build.gradle
dependencies {
    implementation 'com.github.yhaolpz:FloatWindow:1.0.9'
}

// library/build.gradle
apply plugin: 'com.android.library'

android {
    compileSdkVersion 30
    defaultConfig {
        minSdkVersion 19
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    ...
}

在 app/build.gradle 中，添加对 FloatWindow 库的依赖。在 library/build.gradle 中，设置了编译和目标 SDK 版本，以及库的基本信息。

这样，你就有了基本的了解，可以开始尝试集成 FloatWindow 到你的项目中，创建属于自己的悬浮窗功能了。更多信息和详细API用法，请参阅项目文档或源码注释。