|
17 | 17 | </p>
|
18 | 18 | <p>
|
19 | 19 | <sub>
|
20 |
| - Built with ❤︎ by |
| 20 | + Made with ❤︎ by |
21 | 21 | <a href="https://twoyi.io">
|
22 | 22 | Twoyi
|
23 | 23 | </a>
|
|
37 | 37 |
|
38 | 38 | ## Introduction
|
39 | 39 |
|
40 |
| -Twoyi is a lightweight Android container. It can run a relatively complete Android system as a normal app (no ROOT required) on Android. And it supports Android 8.1 ~ 12. |
| 40 | +Twoyi is a lightweight Android container. It runs a relatively complete Android system as a normal app (no root required) on Android. Additionally, it supports Android 8.1 ~ 12. |
41 | 41 |
|
42 | 42 | ## Capability
|
43 | 43 |
|
44 |
| -1. Using Taiji·Yang without unlock bootloader; Xposed, EdXposed, and LSPosed can also be supported later(no ROOT required). |
45 |
| -2. Using ROOT function on Rootless devices. |
46 |
| -3. Magisk module will be partially supported. |
47 |
| -4. The HAL layer of Twoyi is virtualizable; e.g. virtual camera, etc. |
48 |
| -5. Twoyi can also be used for security research; e.g. shelling, etc. |
| 44 | +1. Using Taichi·Yang without unlocking the bootloader. Xposed, EdXposed and LSPosed will also be supported later (no root required). |
| 45 | +2. Using root on non-rooted devices. |
| 46 | +3. Magisk modules will be partially supported. |
| 47 | +4. Implementing additional system components such as virtual camera, thank to the virtualizable HAL layer. |
| 48 | +5. Doing security research such as shelling. |
49 | 49 |
|
50 | 50 | ## Features
|
51 | 51 |
|
52 |
| -1. Twoyi is a rootless Android system-level container; it runs a relatively complete Android system inside and can be isolated to a certain extent from the external system. |
53 |
| -2. The internal Android version is Android 8.1; Android 10 will be supported later. |
54 |
| -3. The booting of Twoyi is very fast, the system can be booted in about three seconds except the first initialization. |
| 52 | +1. Twoyi is a rootless Android system-level container, which runs a relatively complete Android system as a normal app and can be isolated to a certain extent from the external system. |
| 53 | +2. The internal Android version is Android 8.1 and Android 10 will be supported later. |
| 54 | +3. Starting up Twoyi is very fast and the system can be booted in about three seconds except for the initialization. |
55 | 55 | 4. Twoyi is an open source project.
|
56 |
| -5. The internal system of Twoyi will be fully customizable. Because its system is open source, you can pull a branch to compile AOSP; do custom development of system components, such as framework, HAL; implement virtual cameras, virtual sensors and other special features. |
| 56 | +5. The internal system of twoyi will be fully customizable. Because its system is open source, you can fork the project to compile your own AOSP. You can also customize the system components, such as the HAL layer to implement virtual cameras, virtual sensors and other special features. |
57 | 57 |
|
58 | 58 | ## How to Build
|
59 | 59 |
|
60 |
| -Twoyi is divided into two parts: |
| 60 | +Twoyi can be divided into two parts: |
61 | 61 |
|
62 |
| -1. the twoyi App, which is actually a UI rendering engine. |
63 |
| -2. the internal ROM of twoyi. |
| 62 | +1. The twoyi app, which is actually a UI rendering engine. |
| 63 | +2. The internal ROM of twoyi. |
64 | 64 |
|
65 |
| -This repository is the twoyi App, and the twoyi ROM is opensource-ing; therefore, at this stage, the rootfs of the ROM cannot be compiled from the source code yet. |
| 65 | +This repository contains the twoyi app, and the twoyi ROM is being turned into open-source. Therefore, at this time, the rootfs of the ROM cannot be compiled from the source code yet. |
66 | 66 |
|
67 | 67 | ## Build Twoyi ROM
|
68 | 68 |
|
|
72 | 72 |
|
73 | 73 | ### Install Rust
|
74 | 74 |
|
75 |
| -Twoyi is partially written in Rust, please [install Rust and Cargo first](https://www.rust-lang.org/tools/install) |
| 75 | +Twoyi is partially written in Rust, so please [install Rust and Cargo](https://www.rust-lang.org/tools/install) first. |
76 | 76 |
|
77 |
| -You can check it by running: `./gradlew cargoBuild`, if it succeed, you will see the libtwoyi.so in `app/src/main/jniLibs/arm64-v8a`. |
| 77 | +You can check if it is installed by running `./gradlew cargoBuild`, if it succeeded, you will see the libtwoyi.so in `app/src/main/jniLibs/arm64-v8a`. |
78 | 78 |
|
79 | 79 | ### Install cargo-ndk
|
80 | 80 |
|
81 |
| -Please refer: [cargo-ndk](https://github.com/bbqsrc/cargo-ndk) |
| 81 | +Please refer to [cargo-ndk](https://github.com/bbqsrc/cargo-ndk). |
82 | 82 |
|
83 | 83 | ### Integrating rootfs
|
84 | 84 |
|
85 |
| -The ROM of Twoyi is opensource-ing, so you cannot build it now. You can use the prebuilt ROM instead. |
| 85 | +The ROM of twoyi is being turned into open-source, so you cannot build it now. You can use the prebuilt ROM instead. |
86 | 86 |
|
87 |
| -Extracting the rootfs.7z from the official release apk and put it in the `app/assets` directory of this project. |
| 87 | +Extract rootfs.7z from the official release apk and copy it to `app/assets`. |
88 | 88 |
|
89 | 89 | ### Build with Android Studio
|
90 | 90 |
|
91 |
| -Final step, just build it with Android Studio normally. |
| 91 | +Build it with Android Studio normally. |
92 | 92 |
|
93 | 93 | ## Discussion
|
94 | 94 |
|
|
0 commit comments