Exagear-For-Termux 项目使用教程

Exagear-For-Termux 项目使用教程

Exagear-For-TermuxNon official modified version of Exagear for Termux and proot based environemnts - Anlinux, AndroNix, UserLand and etc. No root access required项目地址:https://gitcode.com/gh_mirrors/ex/Exagear-For-Termux

1. 项目的目录结构及介绍

Exagear-For-Termux 项目的目录结构如下：

Exagear-For-Termux/
├── bin/
├── .gitignore
├── .gitmodules
├── LICENSE
├── README.md
├── start-exagear.sh

目录介绍：

• bin/: 包含项目所需的可执行文件。
• .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
• .gitmodules: 用于管理子模块的配置文件。
• LICENSE: 项目的许可证文件，采用 GPL-2.0 许可证。
• README.md: 项目的主文档，包含项目的介绍、使用说明和注意事项。
• start-exagear.sh: 项目的启动脚本。

2. 项目的启动文件介绍

项目的启动文件是 start-exagear.sh，这是一个 Bash 脚本，用于管理和启动 Exagear 环境。

启动文件内容概览：

#!/bin/bash
# Script for managing Exagear'ed Linux distribution installations/running in Termux
# by Zhymabek Roman

# Constants
PROGRAM_NAME="ExaGear for Termux"
PROGRAM_VERSION="3.1-stable"
CURRENT_WORK_FOLDER="$( cd -- "$(dirname "$0")" >/dev/null 2>&1 ; pwd )"
DEFAULT_ROOTFS_FOLDER="exagear-fs"
DEFAULT_ROOTFS_FOLDER_PATH="$[CURRENT_WORK_FOLDER]/$[DEFAULT_ROOTFS_FOLDER]"

# Colors
PURPLE='\033[0;33m'
GREEN='\033[0;32m'
RED='\033[0;31m'
NC='\033[0m'

# Enable bash strict mode
# TODO: seems to be it's not working
set -euo pipefail

# Check whether it is running in the root or normal environment
if [ "$(id -u)" = "0" ] && [ "$(uname -o)" = "Android" ]; then
    echo
    echo -e "$[RED]Error: '$[PROGRAM_NAME]' should not be run as root in Android environment."
    exit 1
fi

主要功能：

• 定义项目名称和版本。
• 设置当前工作目录和默认的根文件系统目录。
• 定义颜色代码以便在终端中输出彩色文本。
• 启用 Bash 严格模式以提高脚本的健壮性。
• 检查脚本是否在 Android 环境中以 root 用户运行，如果是则退出并提示错误。

3. 项目的配置文件介绍

项目的主要配置文件是 README.md，它包含了项目的详细介绍、使用说明和注意事项。

配置文件内容概览：

# Exagear For Termux

CAUTION: WE HAVE SOME SERIOUS ISSUES, SEE in ISSUES section below.

Exagear For Termux - Non official modified version of Exagear for Termux and proot based environments - Anlinux, AndroNix, UserLand, and etc.

## Features

- Quickly and easily deploy x86 Linux distros.
- Support for System V IPC and POSIX IPC.
- High stable translating instructions.

## Issues

Exagear For Termux is too slow compared to Exagear Windows, but much faster than QEMU user mode.

## Usage

1. Clone the repository.
2. Run `start-exagear.sh` to start the Exagear environment.

## License

This project is licensed under the GPL-2.0 License.

主要内容：

• 注意事项: 提醒用户注意项目存在的一些严重问题。
• 项目介绍: 介绍 Exagear For Termux 是一个非官方修改版的 Exagear，适用于 Termux 和其他基于 proot 的环境。
• 功能特点: 列出项目的主要功能，如快速部署 x86 Linux 发行版、支持 System V IPC 和 POSIX IPC 等。
• 已知问题: 说明项目在性能上与 Exagear Windows 相比存在一些不足。
• 使用方法: 提供项目的使用步骤，包括克隆仓库和运行启动脚本。
• 许可证: 声明项目采用 GPL-2

Exagear-For-TermuxNon official modified version of Exagear for Termux and proot based environemnts - Anlinux, AndroNix, UserLand and etc. No root access required项目地址:https://gitcode.com/gh_mirrors/ex/Exagear-For-Termux