This commit is contained in:
2024-12-14 10:43:33 +03:00
parent 7f8090bb1f
commit bbf76e4925
1292 changed files with 2823 additions and 500876 deletions

125
README.md
View File

@@ -2,7 +2,7 @@
[![Commit reviewed](https://github.com/ShawkTeam/pmt/actions/workflows/check_commits.yml/badge.svg)](https://github.com/ShawkTeam/pmt/actions/workflows/check_commits.yml)
This binary, written with C++, is for writing/reading, formatting and getting size on Android partitions.
This is a binary written with C++ and it is for writing/reading, formatting and getting size on Android partitions.
```
Usage: pmt [OPTIONS] backup PARTITION [OUTPUT] [OPTIONS]...
@@ -12,7 +12,7 @@ Usage: pmt [OPTIONS] backup PARTITION [OUTPUT] [OPTIONS]...
Options:
-l, --logical It is meant to determine whether the target partition is logical.
-c, --context It is meant to specify a custom /dev context. Only classic partitions (default: /dev/block/by-name).
-P, --search-path It is meant to specify a custom partition search path. Only classic partitions (default: /dev/block/by-name).
-p, --list List partitions.
-s, --silent Information and warning messages are silenced in normal work.
-f, --force Force mode. Some things are ignored.
@@ -21,55 +21,59 @@ Options:
-v, --version See version.
--help See this help message.
partition-size flags:
--only-size Only the size is displayed, the partition name etc is not displayed.
--as-byte Display size as byte.
--as-kilobyte Display size as kilobyte.
--as-megabyte Display size as megabyte.
--as-gigabyte Display size as gigabyte.
Examples:
pmt backup boot_a -c /dev/block/platform/bootdevice/by-name
pmt backup boot_a -P /dev/block/platform/bootdevice/by-name
pmt flash boot_a /sdcard/twrp/boot.img -c /dev/block/platform/bootdevice/by-name
pmt format system_a ext4 --logical
pmt -c /dev/block/platform/bootdevice/by-name --list
pmt -P /dev/block/platform/bootdevice/by-name --list
pmt partition-size boot --as-byte
pmt partition-size system --only-size --as-gigabyte --logical
Report bugs and suggestions to <t.me/ShawkTeam | Topics | pmt>
```
#### Some notes
### Notes
- pmt supports multiple languages. [See languages.](https://github.com/ShawkTeam/pmt/blob/2.9.0/LANGUAGES.md)
- [Add language.](https://github.com/ShawkTeam/pmt/blob/2.9.0/ADD-LANGUAGES.md)
- pmt now supports multiple languages. [See languages.](https://github.com/ShawkTeam/pmt/blob/2.9.6/LANGUAGES.md)
- [Add a language.](https://github.com/ShawkTeam/pmt/blob/2.9.6/ADD-LANGUAGES.md)
- Feel free to ask any questions you want.
- Packages are available in publications.
- If the logical partition flag is not used, a classic partition is tried to be processing by default.
- [Click to see special version changes.](https://github.com/ShawkTeam/pmt/blob/2.9.0/CHANGELOG.md)
- We are always open to your suggestions and support (developing)!
- [Click to see special version changes.](https://github.com/ShawkTeam/pmt/blob/2.9.6/CHANGELOG.md)
- We are always open to your suggestions and support _(developing)_!
### How is it built?
Make or Android NDK is required to build.
## How to build?
Partition Manager only buildable with Android NDK (make compilation system deprecated).
##### Build with NDK
- [Download Android NDK](https://developer.android.com/ndk/downloads) and extract the NDK package.
- Clone this repository. And get access to it.
```
git clone https://github.com/ShawkTeam/pmt -b 2.9.0
git clone https://github.com/ShawkTeam/pmt -b 2.9.6
cd pmt
```
- Set the NDK working directory variable.
```
make gen-ndk-makefiles
# If you fail the audit etc, use FORCE_GEN.
# Example:
make gen-ndk-makefiles FORCE_GEN=true
export NDK_PROJECT_PATH="${PWD}" # or where the source directory is everywhere
export NDK_ROOT_DIR=<PATH> # Note that if the NDK is in the directory
# Required by Android NDK
export NDK_PROJECT_PATH="${PWD}"
# Generate clang version header
bash build/bash/gen-header
```
- Go to the NDK directory and start the build
```
# Required for creating clang version information and directory access
export NDK_ROOT_DIR="${PWD}"
cd "${NDK_PROJECT_PATH}" \
&& bash build/bash/gen-header \
&& cd "${NDK_ROOT_DIR}"
# Start build
./ndk-build
# Permission denied? Change mode and retry
(sudo) chmod +x ndk-build
# OR
(sudo) chmod 755 ndk-build
```
- The output files will be inside the `pmt` folder. Binaries are available in two architectures within the `libs` folder. `arm64-v8a` (64-bit) and `armeabi-v7a` (32-bit).
```
@@ -86,77 +90,40 @@ cd "${NDK_PROJECT_PATH}" \
pmt pmt
```
##### Build with Makefiles
### Manage pmt with termux script
- Download script.
```
# Setup environment
pkg update \
&& pkg upgrade -y \
&& pkg install make clang binutils xz-utils -y
# Start build
make
# To specify clang, just use PMT_CXX=<clang++> next to the command (and same logic in AR)
# Example:
make PMT_CXX=${PWD}/../toolchain/bin/clang-18
make PMT_AR=${PWD}/../toolchain/bin/ar
make PMT_CXX=${PWD}/../toolchain/bin/clang-18 PMT_AR=${PWD}/../toolchain/bin/ar
# Speficying extra compiler flags on cmd. Example:
make PMT_EXTRA_CXXFLAGS="-O2"
# Use termux :D
# Cleaning working directory
make clean
# Rebuild
make rebuild
# Install
make install
# Uninstall
make uninstall
# Re-install (install & uninstall)
make reinstall
# Manage pmt with termux script
## Download script
curl -LSs https://github.com/ShawkTeam/pmt/raw/2.9.0/pmt-termux.sh > pmt-termux.sh
curl -LSs https://github.com/ShawkTeam/pmt/raw/2.9.6/pmt-termux.sh > pmt-termux.sh
```
- Some informations...
```
## View script help
bash pmt-termux.sh # --help (optional)
## The commands will be told to you anyway. Ask your questions from the telegram group.
```
- For the make installable debian package:
```
make deb <ARCH_NUM>
# Examples
make deb FOR_THIS=64
make deb FOR_THIS=32
```
### How to use
```
# Run
# Directly access root shell
/system/bin/su
# If you are using termux, use with
# tsu (sudo) will be a better choice
pkg install -y tsu # install tsu (sudo)
sudo <COMMAND(S)>
```
- If you have installed the deb package of pmt, installed it with a makefile, or installed it to `$PATH` using any path, just the name of the pmt is enough (or the file name if you did it manually)
```
pmt <...>
(sudo) pmt <ARGUMENT(S)>
```
- If you have not done this type of institution, pmt is in the directory where you are present you can run with `./`.
- If you have not done this type of institution, pmt is in the directory where you are present you can run with `(sudo) ./`.
```
./pmt <...> # or whatever the file name is
(sudo) ./pmt <ARGUMENT(S)> # or whatever the file name is
```
### Notes