# pixelBeans

**Repository Path**: jidong-liu/pixel-beans

## Basic Information

- **Project Name**: pixelBeans
- **Description**: 一款基于 Jetpack Compose 开发的简单像素拼豆 Android 应用
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pixel Beans

Pixel Beans 是一款基于 Jetpack Compose 开发的简单像素拼豆 Android 应用。应用支持设置拼豆颜色和数量，在网格中按坐标创作像素作品，并将作品保存到本地列表或导出为 PNG 图片。

## 功能

- 作品首页
  - 应用启动后默认进入作品列表。
  - 展示已保存作品的名称、保存日期时间和网格尺寸。
  - 支持打开已有作品继续查看或编辑。
  - 支持删除作品。
  - 右下角 `+` 按钮进入创作页面。
  - 顶部 `设置` 按钮进入颜色设置页面。

- 创作页面
  - 支持设置横向 `x` 和纵向 `y` 方格数量，范围为 `10-25`。
  - 方格带横纵坐标标识。
  - 点击颜色方块选择当前拼豆颜色。
  - 颜色方块横向滑动展示，方块内显示剩余数量。
  - 点击网格可放置选中的颜色。
  - 支持切换为橡皮擦并清除单个格子。
  - 支持清空当前画布。
  - 支持保存作品，保存时输入作品名称。
  - 支持导出 PNG 图片。

- 设置页面
  - 使用预设色板选择拼豆颜色。
  - 设置每种颜色的拼豆数量。
  - 点击 `添加 / 更新` 后保存颜色配置，并弹出提示。
  - 支持删除已配置颜色。

## 页面结构

项目将主要功能拆分为三个 Activity：

- `MainActivity`：作品首页。
- `CreateActivity`：创作页面。
- `SettingsActivity`：设置页面。

共享代码拆分为：

- `PixelBeansData.kt`：数据模型、本地存储、PNG 导出和颜色工具函数。
- `PixelBeansScreens.kt`：作品、创作、设置相关 Compose UI 组件。

## 技术栈

- Kotlin
- Android Gradle Plugin
- Jetpack Compose
- Material 3
- SharedPreferences

## 构建要求

- Android Studio 或可用的 Android SDK 环境
- JDK 11+
- Gradle
- 最低 Android 版本：API 25
- Target SDK：36

## 构建与测试

在项目根目录执行：

```powershell
gradle :app:assembleDebug
```

生成的 Debug APK 位于：

```text
app/build/outputs/apk/debug/app-debug.apk
```

运行单元测试：

```powershell
gradle :app:testDebugUnitTest
```

如果本机缺少 Gradle Wrapper 脚本，可以使用系统 Gradle。当前项目包含 `gradle/wrapper/gradle-wrapper.properties`，但未包含 `gradlew` / `gradlew.bat` 脚本。

## 数据存储

应用使用 `SharedPreferences` 保存本地数据：

- 颜色和数量配置。
- 已保存作品列表。
- 每个作品的名称、保存时间、网格尺寸和格子颜色数据。

当前版本没有云同步，卸载应用会清除本地数据。

## PNG 导出

创作页面点击 `导出 PNG` 后，会调用 Android 系统文件创建器。用户选择保存位置后，应用会将当前作品导出为 PNG 图片。