# QuickCompat

**Repository Path**: squirrelhuan/QuickCompat

## Basic Information

- **Project Name**: QuickCompat
- **Description**: 自定义快速开发组件库
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-20
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Quick Compat 库

一个轻量级的 Android 兼容库，提供常用的工具类、UI 组件和兼容性解决方案，简化 Android 应用开发。

## 示例模块

本项目包含多个示例模块用于演示如何使用 Quick Compat 库：

- **app**: 主示例模块，包含完整的功能演示
- **quick-compat-sample**: 独立的普通示例模块，展示基础用法

## 功能特性

- **工具类集合**：提供丰富的工具方法，涵盖设备信息、显示、线程、文件、网络等常用功能
- **UI 组件**：包含自定义按钮、对话框、弹出菜单等 UI 组件
- **兼容性解决方案**：处理 Android 不同版本间的 API 差异
- **资源管理**：提供颜色、动画等资源的统一管理

## 安装说明

### Gradle

将以下依赖添加到您的项目级 build.gradle 文件中：

```gradle
allprojects {
    repositories {
        maven {
            url 'https://jitpack.io'
        }
    }
}
```

然后在应用模块的 build.gradle 中添加依赖：

```gradle
dependencies {
    implementation 'com.gitee.你的gitee用户名:quick-compat:1.0.38'
}
```

## 使用示例

### 1. 工具类使用

#### DisplayUtil - 显示相关工具

```java
// 获取状态栏高度
int statusBarHeight = DisplayUtil.getStatusBarHeight(context);

// 获取 ActionBar 高度
int actionBarHeight = DisplayUtil.getActionBarHeight(context);
```

#### QuickThread - 线程管理

```kotlin
// 在主线程运行
QuickThread.runOnUiThread {
    // UI 操作
    textView.text = "更新 UI"
}

// 在子线程运行
QuickThread.runOnSubThread {
    // 耗时操作
    val result = performHeavyTask()
    QuickThread.runOnUiThread {
        // 回到主线程更新 UI
        textView.text = result
    }
}
```

#### QDBitmapUtil - 图片处理工具

```java
// 缩放图片
Bitmap scaledBitmap = QDBitmapUtil.scaleBitmap(bitmap, 300, 300);

// 裁剪图片
Bitmap croppedBitmap = QDBitmapUtil.cropBitmap(bitmap);
```

#### DeviceUtil - 设备信息工具

```kotlin
// 获取设备唯一标识
val deviceId = DeviceUtil.getPesudoUniqueID()

// 获取 Android ID
val androidId = DeviceUtil.getAndroidID(context)
```

### 2. UI 组件使用

#### 自定义按钮

```xml
<com.demomaster.quickcompat.widget.button.QuickButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Primary Button"
    android:background="@drawable/quick_btn_bg_primary"
    android:textColor="@color/quick_btn_text_color_primary" />
```

#### 对话框

```java
// 创建简单对话框
QuickDialog dialog = new QuickDialog.Builder(context)
    .setTitle("提示")
    .setMessage("这是一条提示信息")
    .setPositiveButton("确定", null)
    .create();
dialog.show();
```

### 3. Kotlin 与 Java 互操作

库中的 Kotlin 工具类都添加了 `@JvmStatic` 注解，可以在 Java 代码中方便调用：

```java
// Java 中调用 Kotlin 静态方法
QuickThread.runOnUiThread(new Runnable() {
    @Override
    public void run() {
        // UI 操作
    }
});
```

## 项目结构

- **activity**: 提供常用的 Activity 基类和对话框实现
- **animation**: 动画相关工具和自定义动画
- **content**: 内容提供者相关工具
- **decorator**: RecyclerView 装饰器
- **drawable**: 自定义 Drawable 实现
- **listener**: 各种监听器实现
- **service**: 服务相关工具
- **util**: 通用工具类
- **view**: 自定义视图组件
- **widget**: 常用 UI 控件
- **quick-compat-sample**: 独立的普通示例模块，展示基础用法

## 版本历史

- **1.0.38**: 当前版本

## 贡献指南

欢迎提交 Issues 和 Pull Requests 来帮助改进这个库。

## 许可证

此项目使用 MIT 许可证。