修改 README.md 格式

在不破坏内容的前提下修改了 README.md,以使得可读性更强。
This commit is contained in:
Karlbaey
2025-05-02 20:16:41 +08:00
committed by Caten
parent 07224a73f6
commit 018352b152
2 changed files with 70 additions and 47 deletions

101
README.md
View File

@@ -1,67 +1,92 @@
<p align="center"><img src="readme/cover0.png" alt="小小电脑使用照片" height="400"></img></p>
# 小小电脑
<img decoding="async" src="readme/cover0.png" width="50%">
给所有安卓arm64设备的“PC应用引擎”平替
给所有安卓arm64设备的“PC应用引擎”平替。你可以在小小电脑上安装PC级WPS、CAJ Viewer、亿图图示等软件。
Click-to-run Debian Bookworm XFCE on Android for Chinese users, with the Fcitx Pinyin input method preinstalled. No Termux is required. If you want to change the language in the container, run "tmoe", since this root filesystem is made using [tmoe](https://github.com/2moe/tmoe).
## 特点
- 一键安装,即开即用
- 来自kali-undercoverwin10主题(仅xfce版本),友好的界面
- 来自 kali-undercoverwin10 主题(仅 xfce 版本),友好的界面
<img decoding="async" src="readme/img1.png" width="50%">
![1](readme/img1.png)
- 提供常用软件的一键安装指令
<img decoding="async" src="readme/img2.png" width="50%">
![1](readme/img2.png)
- 可方便地改变屏幕缩放,不用担心屏幕过大或过小
<img decoding="async" src="readme/img3.gif" width="50%">
![1](readme/img3.gif)
- 便捷访问设备文件或通过设备SAF访问软件文件
- 便捷访问设备文件,或通过设备 SAF 访问软件文件
<img decoding="async" src="readme/img4.png" width="50%">
![1](readme/img4.png)
- 提供终端和众多可调节参数供高级用户使用
<img decoding="async" src="readme/img5.png" width="50%">
![1](readme/img5.png)
## 下载
小小电脑提供多个版本。要将小小电脑作为PC应用引擎使用请在[Releases](https://github.com/Cateners/tiny_computer/releases)页面下载并安装[XFCE](https://xfce.org/)版本tiny-computer-xfce.apk
如果遇到黑屏问题,请卸载后尝试[LXQt](https://lxqt-project.org/)版本Releases页寻找tiny-computer-lxqt.apk
这些版本的区别在于桌面环境不同。你可以简单地理解为界面不一样,但功能基本一致。
LXQt的界面示例
![1](https://lxqt-project.org/images/screenshots/ambiance.png)
如果你下载小小电脑是为了体验更多桌面环境享受折腾Linux的乐趣这里也有一些其他版本供下载
和[GXDE](https://www.gxde.org/)团队合作的版本[#129](https://github.com/Cateners/tiny_computer/issues/129)。可在[此处](https://mirrors.sdu.edu.cn/spark-store-repository/GXDE-OS/APK/)下载。GXDE的界面示例
![1](https://www.gxde.org/1.png)
由[灵墨桌面](https://www.lingmo.org/)开发者提供的版本[#218](https://github.com/Cateners/tiny_computer/issues/218)。灵墨桌面的界面[示例](https://www.bilibili.com/video/BV1Ci421R7AR)
## 原理
使用proot运行debian环境
使用 proot 运行 debian 环境
内置[noVNC](https://github.com/novnc/noVNC)/[AVNC](https://github.com/gujjwal00/avnc)/[Termux:X11](https://github.com/termux/termux-x11)显示图形界面
内置 [noVNC](https://github.com/novnc/noVNC)/[AVNC](https://github.com/gujjwal00/avnc)/[Termux:X11](https://github.com/termux/termux-x11) 显示图形界面
## 项目结构
assets的文件源信息可以在[这里](extra/readme.md)找到。
assets 的文件源信息可以在[这里](https://github.com/Cateners/tiny_computer/blob/master/extra/readme.md)找到。
完整的容器制作过程可以在[这里](extra/build-tiny-rootfs.md)看到。
完整的容器制作过程可以在[这里](https://github.com/Cateners/tiny_computer/blob/master/extra/build-tiny-rootfs.md)看到。
数据包不再在assets中更新而是随releases提供主要是为了避免git越来越大
数据包不再在 assets 中更新,而是随 releases 提供,主要是为了避免 git 越来越大
lib目录
lib 目录:
- main.dart文件页面布局有点乱
- workflow.dart文件逻辑部分目前也还可以理解
- Util 工具类
- TermPty 一个终端
- G 全局变量类
- Workflow 从软件点开到容器启动的所有步骤
- main.dart 文件,页面布局,有点乱
- workflow.dart 文件,逻辑部分,目前也还可以理解
- Util 工具类
- TermPty 一个终端
- G 全局变量类
- Workflow 从软件点开到容器启动的所有步骤
## 编译
你需要配置好flutter和安卓sdk还需安装python3、bison、patchgcc然后克隆此项目。
你需要配置好 flutter 和安卓 sdk还需安装 python3、bison、patchgcc然后克隆此项目。
在编译之前需要在release中下载patch.tar.gz拷贝到assets以及下载系统rootfs(或者[自行制作](extra/build-tiny-rootfs.md))之后使用split命令分割拷贝到assets。一般我将其分为98MB。
在编译之前,需要在 release 中下载 patch.tar.gz 拷贝到 assets以及下载系统 rootfs或者[自行制作](https://github.com/Cateners/tiny_computer/blob/master/extra/build-tiny-rootfs.md),之后使用 split 命令分割,拷贝到 assets。一般我将其分为 98MB。
`split -b 98M debian.tar.xz`
```bash
split -b 98M debian.tar.xz
```
还需要对 flutter 的一些默认配置作修改,因为其与项目中 build.gradle 的一些设置冲突。
- 注释或删除 `flutter\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy` 路径下与 `ShrinkResources` 相关的 `if` 代码块。
还需要对flutter的一些默认配置作修改因为其与项目中build.gradle的一些设置冲突。
- 注释或删除`flutter\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy`路径下与`ShrinkResources`相关的`if`代码块。
```groovy
// if (shouldShrinkResources(project)) {
// release {
@@ -80,23 +105,23 @@ lib目录
接下来就可以编译了。我使用的命令如下:
`flutter build apk --target-platform android-arm64 --split-per-abi --obfuscate --split-debug-info=tiny_computer/sdi`
```bash
flutter build apk --target-platform android-arm64 --split-per-abi --obfuscate --split-debug-info=tiny_computer/sdi
```
有一些C代码可能报错。比如KeyBind.c等文件报错一些符号未定义。但其实包含那些符号的函数并没有被使用所以可以把它们删掉再编译。
应该有编译选项可以避免这种情况但我对cmake不熟就先这样了:P
有一些 C 代码可能报错。比如 KeyBind.c 等文件,报错一些符号未定义。但其实包含那些符号的函数并没有被使用,所以可以把它们删掉再编译。 应该有编译选项可以避免这种情况,但我对 cmake 不熟,就先这样了:P
## 目前已知bug
## 目前已知 bug
多用户/分身情形无法sudo, 其它见issue
多用户/分身情形无法 sudo , 其它见 issue
## 一些链接
这是我的第一个flutter软件感谢这些项目为我指路
这是我的第一个 flutter 软件,感谢这些项目为我指路
- 要一点基础的 [《Flutter实战·第二版》](https://book.flutterchina.club)
- 要一点基础的[《Flutter实战·第二版》](https://book.flutterchina.club/)
- 也许是零基础的Flutter视频课程 [freeCodeCamp Flutter Course](https://www.youtube.com/watch?v=wFn-m-OgKPU&list=PL6yRaaP0WPkVtoeNIGqILtRAgd3h2CNpT)
- 安卓上的VS Code [Code FA](https://github.com/nightmare-space/vscode_for_android)
- 安卓上的 VS Code [Code FA](https://github.com/nightmare-space/vscode_for_android)
## Getting Started
@@ -107,6 +132,4 @@ A few resources to get you started if this is your first Flutter project:
- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
For help getting started with Flutter development, view the [online documentation](https://docs.flutter.dev/), which offers tutorials, samples, guidance on mobile development, and a full API reference.

View File

@@ -13,10 +13,10 @@ packages:
dependency: transitive
description:
name: async
sha256: d2872f9c19731c2e5f10444b14686eb7cc85c76274bd6c16e1816bff9a3bab63
sha256: "758e6d74e971c3e5aceb4110bfd6698efc7f501675bcfe0c775459a8140750eb"
url: "https://pub.dev"
source: hosted
version: "2.12.0"
version: "2.13.0"
boolean_selector:
dependency: transitive
description:
@@ -109,10 +109,10 @@ packages:
dependency: transitive
description:
name: fake_async
sha256: "6a95e56b2449df2273fd8c45a662d6947ce1ebb7aafe80e550a3f68297f3cacc"
sha256: "5368f224a74523e8d2e7399ea1638b37aecfca824a3cc4dfdf77bf1fa905ac44"
url: "https://pub.dev"
source: hosted
version: "1.3.2"
version: "1.3.3"
ffi:
dependency: transitive
description:
@@ -204,10 +204,10 @@ packages:
dependency: transitive
description:
name: leak_tracker
sha256: c35baad643ba394b40aac41080300150a4f08fd0fd6a10378f8f7c6bc161acec
sha256: "6bb818ecbdffe216e81182c2f0714a2e62b593f4a4f13098713ff1685dfb6ab0"
url: "https://pub.dev"
source: hosted
version: "10.0.8"
version: "10.0.9"
leak_tracker_flutter_testing:
dependency: transitive
description:
@@ -633,10 +633,10 @@ packages:
dependency: transitive
description:
name: vm_service
sha256: "0968250880a6c5fe7edc067ed0a13d4bae1577fe2771dcf3010d52c4a9d3ca14"
sha256: ddfa8d30d89985b96407efce8acbdd124701f96741f2d981ca860662f1c0dc02
url: "https://pub.dev"
source: hosted
version: "14.3.1"
version: "15.0.0"
wakelock_plus:
dependency: "direct main"
description: