mirror of
https://github.com/Cateners/tiny_computer.git
synced 2026-05-20 16:35:47 +08:00
140 lines
7.7 KiB
Markdown
140 lines
7.7 KiB
Markdown
[](https://github.com/Cateners/tiny_computer/blob/master/readme/cover0.png)
|
||
|
||
# 小小电脑
|
||
|
||
给所有安卓 arm64 设备的“PC 应用引擎”平替。你可以在小小电脑上安装 PC 级 WPS、CAJ Viewer、亿图图示等软件。
|
||
|
||
Run Debian Bookworm with XFCE/LXQt/... on Android with just one click - optimized for Chinese users. This package comes preinstalled with the Fcitx Pinyin input method and doesn't require Termux.
|
||
|
||
To change the language in the container, simply run the "tmoe" command (this root filesystem was created using [tmoe](https://github.com/2moe/tmoe)). You'll need to remove the LANG=zh_CN.UTF-8 environment variable from the startup command (Control -> Advanced Settings -> Startup Command) when switching languages.
|
||
|
||
Note: Since version 1.0.23, English UI is supported, though some hint texts remain in Chinese.
|
||
|
||
## 特点
|
||
|
||
- 一键安装，即开即用
|
||
- 来自 kali-undercover 的 win10 主题(仅 xfce 版本)，友好的界面
|
||
|
||
[](https://github.com/Cateners/tiny_computer/blob/master/readme/img1.png)
|
||
|
||
- 提供常用软件的一键安装指令
|
||
|
||
[](https://github.com/Cateners/tiny_computer/blob/master/readme/img2.png)
|
||
|
||
- 可方便地改变屏幕缩放，不用担心屏幕过大或过小
|
||
|
||
[](https://github.com/Cateners/tiny_computer/blob/master/readme/img3.gif)
|
||
|
||
- 便捷访问设备文件，或通过设备 SAF 访问软件文件
|
||
|
||
[](https://github.com/Cateners/tiny_computer/blob/master/readme/img4.png)
|
||
|
||
- 提供终端和众多可调节参数供高级用户使用
|
||
|
||
[](https://github.com/Cateners/tiny_computer/blob/master/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](https://github.com/Cateners/tiny_computer/releases) 页寻找 tiny-computer-lxqt.apk）。
|
||
|
||
这些版本的区别在于桌面环境不同。你可以简单地理解为界面不一样，但功能基本一致。
|
||
|
||
LXQt 的界面示例：
|
||
|
||
[](https://camo.githubusercontent.com/016ff8803c228f26db750c8424777d8e04a3aebec4ff11d8436a0b22a2e6f58a/68747470733a2f2f6c7871742d70726f6a6563742e6f72672f696d616765732f73637265656e73686f74732f616d6269616e63652e706e67)
|
||
|
||
如果你下载小小电脑是为了体验更多桌面环境，享受折腾 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 的界面示例：
|
||
|
||
[](https://www.gxde.top/1.jpg)
|
||
|
||
由[灵墨桌面](https://www.lingmo.org/)开发者提供的版本[#218](https://github.com/Cateners/tiny_computer/issues/218)。灵墨桌面的界面[示例](https://www.bilibili.com/video/BV1Ci421R7AR)。
|
||
|
||
## 原理
|
||
|
||
使用 proot 运行 debian 环境。
|
||
|
||
内置 [noVNC](https://github.com/novnc/noVNC)/[AVNC](https://github.com/gujjwal00/avnc)/[Termux:X11](https://github.com/termux/termux-x11) 显示图形界面。
|
||
|
||
## 项目结构
|
||
|
||
assets 和 android/app/src/main/jniLibs 的文件源信息可以在[这里](https://github.com/Cateners/tiny_computer/blob/master/extra/readme.md)找到。
|
||
|
||
完整的容器制作过程可以在[这里](https://github.com/Cateners/tiny_computer/blob/master/extra/build-tiny-rootfs.md)看到。
|
||
|
||
数据包、patch.tar.gz 以及 jniLibs 的文件不在代码仓更新，而是随 releases 提供，主要是为了避免 git 越来越大。
|
||
|
||
lib 目录：
|
||
|
||
- main.dart 文件，页面布局，有点乱
|
||
- workflow.dart 文件，逻辑部分，目前也还可以理解
|
||
- Util 工具类
|
||
- TermPty 一个终端
|
||
- G 全局变量类
|
||
- Workflow 从软件点开到容器启动的所有步骤
|
||
- l10n 文件夹，包含多语言文件
|
||
|
||
## 编译
|
||
|
||
你需要配置好 flutter 和安卓 sdk，还需安装 python3、bison、patch 和 gcc，然后克隆此项目。
|
||
|
||
在编译之前，需要在 release 中下载 jniLibs.zip ，将里面的库文件解压后放到 android/app/src/main/jniLibs/arm64-v8a；下载 patch.tar.gz 拷贝到 assets。以及下载系统 rootfs（或者[自行制作](https://github.com/Cateners/tiny_computer/blob/master/extra/build-tiny-rootfs.md)），之后使用 split 命令分割，拷贝到 assets。一般我将其分为 98MB。
|
||
|
||
```bash
|
||
split -b 98M debian.tar.xz
|
||
```
|
||
|
||
还需要对 flutter 的一些默认配置作修改，因为其与项目中 build.gradle 的一些设置冲突。
|
||
|
||
- 注释或删除 `flutter\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy` 路径下与 `ShrinkResources` 相关的 `if` 代码块。
|
||
|
||
```groovy
|
||
// if (shouldShrinkResources(project)) {
|
||
// release {
|
||
// // Enables code shrinking, obfuscation, and optimization for only
|
||
// // your project's release build type.
|
||
// minifyEnabled(true)
|
||
// // Enables resource shrinking, which is performed by the Android Gradle plugin.
|
||
// // The resource shrinker can't be used for libraries.
|
||
// shrinkResources(isBuiltAsApp(project))
|
||
// // Fallback to `android/app/proguard-rules.pro`.
|
||
// // This way, custom Proguard rules can be configured as needed.
|
||
// proguardFiles(project.android.getDefaultProguardFile("proguard-android-optimize.txt"), flutterProguardRules, "proguard-rules.pro")
|
||
// }
|
||
// }
|
||
```
|
||
|
||
接下来就可以编译了。我使用的命令如下：
|
||
|
||
```bash
|
||
flutter build apk --target-platform android-arm64 --split-per-abi --obfuscate --split-debug-info=tiny_computer/sdi
|
||
```
|
||
|
||
有一些 C 代码可能报错。比如 KeyBind.c 等文件，报错一些符号未定义。但其实包含那些符号的函数并没有被使用，所以可以把它们删掉再编译。 应该有编译选项可以避免这种情况，但我对 cmake 不熟，就先这样了:P
|
||
|
||
## 目前已知 bug
|
||
|
||
多用户/分身情形无法 sudo , 其它见 issue。
|
||
|
||
## 一些链接
|
||
|
||
这是我的第一个 flutter 软件，感谢这些项目为我指路
|
||
|
||
- 要一点基础的[《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)
|
||
|
||
## Getting Started
|
||
|
||
This project is a starting point for a Flutter application.
|
||
|
||
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.
|