# dbmanager

**Repository Path**: yiyang6code/dbmanager

## Basic Information

- **Project Name**: dbmanager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-22
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DB Manager

SuperD 3Dbox 原生的 boxlauncher 已停止服务，无法在桌面添加应用和游戏。通过分析 Launcher 数据库结构，列出设备上所有已安装应用，支持一键添加/删除到 Launcher（`com.runmit.boxlauncher`）的 `appInstallInfo.db` 数据库中，让第三方应用和游戏也能显示在桌面上。

## 功能

- 列出所有已安装应用（支持过滤系统应用）
- 点击应用弹窗选择操作：
  - **未添加** → 选择添加为"普通 App"或"游戏"
  - **已添加** → 从桌面删除
- 已添加的应用显示 ✅ 标记
- 刷新桌面（force-stop Launcher）

## 权限

- 需要 **root 权限**（Magisk 授权）
- 不需要 `FACTORY_TEST` 或存储权限

## 工作原理

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | `su -c cp` 源DB → App本地目录 | 触发 Magisk 授权 |
| 2 | `su -c chmod 666` 本地副本 | 让 Java 层可读写 |
| 3 | Java `SQLiteDatabase` 操作本地副本 | 无权限问题 |
| 4 | `su -c cp` 覆盖回源目录 | 写回修改 |
| 5 | `su -c chown` + `chmod 660` | 恢复文件 owner 和权限 |

## 数据库结构

**位置：** `/data/data/com.runmit.boxlauncher/databases/appInstallInfo.db`

**表名：** `installInfo`

```sql
CREATE TABLE installInfo (
    PACKEGE_NAME     TEXT PRIMARY KEY,   -- 包名（主键）
    APP_NAME         TEXT,               -- 显示名称
    APP_TYPE         Integer,            -- 1=普通App, 2=游戏
    APP_CMSID        TEXT,               -- 固定填 "0"
    APP_START_TIME   TEXT,               -- 时间戳（秒）
    APP_REMOTEVERSION TEXT,              -- 固定填 "2.0.1"
    APP_VERSIONCODE  TEXT                -- 版本号
);
```

### 字段说明

| 字段 | 必填 | 示例 | 说明 |
|------|------|------|------|
| PACKEGE_NAME | ✅ | `"com.mixplorer"` | App 的包名，唯一标识 |
| APP_NAME | ✅ | `"MiXplorer"` | 桌面显示的应用名称 |
| APP_TYPE | ✅ | `1` | 1=普通App, 2=游戏（影响桌面分类） |
| APP_CMSID | ✅ | `"0"` | 固定填 "0" |
| APP_START_TIME | ✅ | `"1783759420509"` | `System.currentTimeMillis()/1000` |
| APP_REMOTEVERSION | ✅ | `"2.0.1"` | 固定填 "2.0.1" |
| APP_VERSIONCODE | ✅ | `"1"` | 版本号（字符串） |

## 文件结构

```
app/src/main/java/com/boxlauncher/dbmanager/
├── LauncherDBHelper.java    # 数据库操作工具类
└── MainActivity.java        # 主界面

app/src/main/res/layout/
└── activity_main.xml        # 布局
```

## 构建

```bash
./gradlew assembleDebug
# APK: app/build/outputs/apk/debug/app-debug.apk
```