mirror of
https://github.com/TriM-Organization/Linglun-Converter.git
synced 2026-01-19 10:12:01 +00:00
176 lines
5.3 KiB
Markdown
176 lines
5.3 KiB
Markdown
## 使用前的准备工作
|
||
|
||
### 安装终端工具
|
||
|
||
这里我们选用 **Termux** 作为我们的终端工具来安装，这是一个强大的终端模拟器，旨在安卓环境下模拟Linux的软件包环境。
|
||
|
||
> **注意** 若你的设备中已经有终端工具（例如 Utermux 之类的），请跳过此步骤。
|
||
|
||
1. 下载
|
||
|
||
下载可以通过 [GitHub源](https://github.com/termux/termux-app/releases) 或者 [F-Droid源](https://f-droid.org/en/packages/com.termux/) ，个人建议选择 F-Droid 源，因为在国内可以访问得到，而 GitHub 源就看运气。
|
||
|
||
2. 安装
|
||
|
||
下载*APK*包后直接安装，安装后打开可以看到一个类似这样的界面：
|
||
|
||
<img height="512" src="https://foruda.gitee.com/images/1665933025120627254/a0479618_9911226.jpeg">
|
||
|
||
3. 完成
|
||
|
||
恭喜你，你已经获得了一个极客般流畅地操作你手机的终端工具。
|
||
|
||
### 安装运行环境
|
||
|
||
1. 换源
|
||
|
||
接下来，我们就要来准备安装一下 **Python** 运行环境了，这是运行 **Python** 源代码必要的。
|
||
|
||
首先，我估计你等不了多久，急得要死，所以我们要让下载速度稍微快一点，先来换个源。在 **Termux** 中，输入以下指令：
|
||
|
||
> **注意** 这条指令很长，执行时请左右滑动以复制全部内容。
|
||
|
||
```bash
|
||
echo "deb https://mirror.mwt.me/termux/main stable main" > /data/data/com.termux/files/usr/etc/apt/sources.list
|
||
```
|
||
|
||
*感谢 天如<QQ 3291691454>为我们带来的简单换源方法。*
|
||
|
||
- *非必要步骤*：手动编辑换源
|
||
|
||
> **注意** 这是非必要的步骤，执行了也没有好处，小白别闲着没事干。
|
||
|
||
如果你闲着没事，非要要手动编辑个文档来换源，那就可以遵循这一部分的内容，我们先打开 **nano** 吧。
|
||
|
||
在 **Termux** 中，输入以下指令：
|
||
|
||
```bash
|
||
export EDITOR=nano
|
||
apt edit-sources
|
||
```
|
||
|
||
那么请把看到的如左下图的界面变为右下图吧：
|
||
|
||
<table><tr>
|
||
<td><img src="https://foruda.gitee.com/images/1665933104313107707/41108f03_9911226.jpeg"></td>
|
||
<td><img src="https://foruda.gitee.com/images/1665933122534781330/3887a901_9911226.jpeg"></td>
|
||
</tr></table>
|
||
|
||
- 图片中的文件，最后应该加入的两行为：
|
||
|
||
```bash
|
||
deb https://mirrors.ustc.edu.cn/termux/apt/termux-main/ stable main
|
||
deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main/ stable main
|
||
```
|
||
|
||
然后键入 `Ctrl`+`S`，再键入 `Ctrl`+`X`，退出`nano`。
|
||
|
||
在换源之后，你可能会见到类似的提示（“可能会”的意思是也可能不会）：
|
||
|
||
```bash
|
||
Your '/data/data/com.termux/files/usr/etc/apt/sources.list' file changed. Please run 'apt-get update'.
|
||
```
|
||
|
||
那就遵循它的指引（但无论出没出现上面的那个提示，都请执行下面的指令），输入：
|
||
|
||
```bash
|
||
apt-get update
|
||
```
|
||
|
||
Alright.
|
||
|
||
2. 安装 **Python**
|
||
|
||
```bash
|
||
apt-get install python3
|
||
```
|
||
|
||
如果遇到提示问是否继续，那就输入`Y`表示是，如左下图，安装成功后，图若右下。
|
||
|
||
<table><tr>
|
||
<td><img src="https://foruda.gitee.com/images/1665933181440420034/7f0fb5fd_9911226.jpeg"></td>
|
||
<td><img src="https://foruda.gitee.com/images/1665933238339972260/a9f06f4f_9911226.jpeg"></td>
|
||
</tr></table>
|
||
|
||
接下来，我们来试一试 **Python** 是不是安装成了吧，输入
|
||
|
||
```bash
|
||
python3 -V
|
||
```
|
||
|
||
如果输出了形如 `Python 3.X.X` 的提示，则完成。
|
||
|
||
3. 构建环境并安装依赖库
|
||
|
||
以下长段中井号“#”开头的是注释，无需复制输入。
|
||
|
||
```bash
|
||
# 首先换源
|
||
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
|
||
# 然后安装 numpy
|
||
apt-get install python-numpy
|
||
# 新建虚拟环境
|
||
python -m venv ./.venv
|
||
```
|
||
|
||
<!--
|
||
安装成功后您可能会见到类似下图的提示：
|
||
|
||
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
|
||
-->
|
||
|
||
### 安装下载工具
|
||
|
||
既然已经有了运行环境，那么我们就需要下载一个用来下载我们的**伶伦转换器**的工具，我非常推崇**Git**这种方便快捷好用还能下载仓库的代码管理器，这个世界上你也找不到第二个，所以我们来安装一下：
|
||
|
||
```bash
|
||
apt install git
|
||
```
|
||
|
||
安装完成后可以测试一下是否安装成功：
|
||
|
||
```bash
|
||
git --version
|
||
```
|
||
|
||
你可能会见到类似 `git version 2.x.x` 的提示，表示安装成功。
|
||
|
||
<!--
|
||
<img height="512" src="https://foruda.gitee.com/images/1665933331269483373/9374c85d_9911226.jpeg">
|
||
-->
|
||
|
||
## 本软件的下载与使用
|
||
|
||
0. 使用Git下载本程序代码
|
||
|
||
```git
|
||
git clone https://gitee.com/TriM-Organization/Linglun-Converter.git llc
|
||
```
|
||
|
||
当上述命令执行成功，你会在执行此命令的所在位置发现一个名为 `llc` 的文件夹，其中包含的正是我们心心念念下载的本程序源代码。
|
||
本程序可以直接从源代码运行，因此，赶快进入下载到的文件夹：
|
||
|
||
```bash
|
||
cd llc
|
||
```
|
||
|
||
1. 开始使用命令行程序
|
||
|
||
执行以下命令以运行伶伦转换器：
|
||
|
||
```bash
|
||
source ./run_cli.sh
|
||
```
|
||
|
||
运行成功了，哦耶！
|
||
|
||
<img height="512" src="https://foruda.gitee.com/images/1686963721390700714/b82fb3d5_9911226.png">
|
||
|
||
2. 软件更新
|
||
|
||
有时可能需要更新本程序，请在进入到本程序所在的文件夹（上述`cd llc`即此）后，执行以下命令：
|
||
|
||
```bash
|
||
git pull
|
||
```
|