# carfloatballreadme
**Repository Path**: taoziD/carfloatballreadme
## Basic Information
- **Project Name**: carfloatballreadme
- **Description**: 适用于24款岚图擎感车机的悬浮球软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 6
- **Forks**: 1
- **Created**: 2026-01-07
- **Last Updated**: 2026-02-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 🚗 CarFloatBall 安装与配置指南
> 本文档专为 **首次安装** 用户设计，帮助您快速完成环境搭建。
## 📋 目录
- [1. 安装应用](#1-安装应用)
- [2. 一键授权命令（推荐）](#2-一键授权命令推荐)
- [3. 核心权限授权](#3-核心权限授权)
- [4. 进阶权限配置](#4-进阶权限配置)
- [5. 首次启动](#5-首次启动)
- [6. 常见问题排查](#6-常见问题排查)
- [7. 快速授权脚本](#7-快速授权脚本)
- [8. 联系与支持](#8-联系与支持)
---
## 1. 安装应用
> ⚠️ **前提条件**：确保您的电脑已连接车机/手机，并已开启 USB 调试模式。
```bash
# 安装 APK（替换为您实际的 apk 路径）
adb install -r app-debug.apk
```
---
## 2. 一键授权命令（推荐）
> 💡 **懒人必备**：复制粘贴以下命令，即可完成全部权限授权并自动启动应用！
```bash
adb shell "appops set com.carfloat.ball SYSTEM_ALERT_WINDOW allow && settings put secure enabled_accessibility_services com.carfloat.ball/com.carfloat.ball.service.FloatAccessibilityService && settings put secure accessibility_enabled 1 && pm grant com.carfloat.ball android.permission.WRITE_SECURE_SETTINGS && dumpsys deviceidle whitelist +com.carfloat.ball && appops set com.carfloat.ball RUN_IN_BACKGROUND allow && appops set com.carfloat.ball REQUEST_INSTALL_PACKAGES allow && appwidget grantbind --package com.carfloat.ball --user 0" && sleep 1 && adb shell "settings put secure enabled_accessibility_services '' && sleep 1 && settings put secure enabled_accessibility_services com.carfloat.ball/com.carfloat.ball.service.FloatAccessibilityService && settings put secure accessibility_enabled 1 && am start -n com.carfloat.ball/.MainActivity"
```
此命令包含：
- ✅ 悬浮窗权限
- ✅ 无障碍服务
- ✅ 安全设置写入权限
- ✅ 电池白名单
- ✅ 后台运行权限
- ✅ 安装未知应用权限
- ✅ **悬浮窗卡片微件授权**
- ✅ 自动启动应用
---
## 3. 核心权限授权
> 如果一键命令不适用，可以逐条执行以下命令。
### 3.1 悬浮窗权限（必须）
> 没有此权限，悬浮球将无法显示。
```bash
adb shell appops set com.carfloat.ball SYSTEM_ALERT_WINDOW allow
```
### 3.2 第三方应用悬浮窗权限（可选）
> 适用于高德地图、QQ 音乐等第三方应用。
**高德地图车机版：**
```bash
adb shell appops set com.autonavi.amapauto SYSTEM_ALERT_WINDOW allow
```
**QQ 音乐车机版：**
```bash
adb shell appops set com.tencent.qqmusiccar SYSTEM_ALERT_WINDOW allow
```
---
## 4. 进阶权限配置
由于部分车机系统精简了设置界面，建议直接使用命令行开启以下权限。
### 4.1 无障碍服务（必须）
> 用于实现「返回」「主页」等模拟按键功能。
**激活无障碍服务：**
```bash
adb shell settings put secure enabled_accessibility_services com.carfloat.ball/com.carfloat.ball.service.FloatAccessibilityService && adb shell settings put secure accessibility_enabled 1
```
**解决重启后无障碍服务失效问题：**
```bash
adb shell pm grant com.carfloat.ball android.permission.WRITE_SECURE_SETTINGS
```
### 4.2 后台保活设置（推荐）
> 防止应用被系统后台清理或重启后无法自动运行。
```bash
# 加入电池优化白名单
adb shell dumpsys deviceidle whitelist +com.carfloat.ball
# 允许后台运行
adb shell appops set com.carfloat.ball RUN_IN_BACKGROUND allow
```
### 4.3 安装未知应用权限（用于在线升级）
```bash
# 允许本应用安装更新
adb shell appops set com.carfloat.ball REQUEST_INSTALL_PACKAGES allow
# 允许高德地图安装更新
adb shell appops set com.autonavi.amapauto REQUEST_INSTALL_PACKAGES allow
```
### 4.4 悬浮窗卡片微件授权
```bash
adb shell appwidget grantbind --package com.carfloat.ball --user 0
```
---
## 5. 首次启动
> 安装完成后，由于没有桌面图标或系统限制，**必须使用命令行首次启动**。
```bash
adb shell am start -n com.carfloat.ball/.MainActivity
```
---
## 6. 常见问题排查
如果遇到问题，可以使用以下命令进行排查或重置：
| 操作 | 命令 |
| ------------ | ------------------------------------------- |
| 强制停止应用 | `adb shell am force-stop com.carfloat.ball` |
| 卸载应用 | `adb uninstall com.carfloat.ball` |
| 查看应用日志 | `adb logcat -s CarFloatBall AndroidRuntime` |
---
## 7. 快速授权脚本
下载对应平台的脚本，可一键完成所有授权操作。
### macOS
```bash
chmod +x macos_command.sh
./macos_command.sh
```
📥 [下载 macOS 脚本](https://gitee.com/taoziD/carfloatballreadme/blob/master/macos_command.sh)
### Windows
> ⚠️ 需要用 **管理员身份** 运行 CMD 或 PowerShell。
📥 [下载 Windows 脚本](https://gitee.com/taoziD/carfloatballreadme/blob/master/windows_command.bat)
---
## 8. 联系与支持
### 💬 加入交流群
欢迎加入交流群，反馈 bug、交流心得、分享想法！
---
### ☕ 打赏支持
如果您觉得此应用对您有帮助，欢迎打赏支持作者！
支付宝
|
微信支付
|