Termux for HarmonyOS Computer. Working in Progress.
It can run some basic commands on Huawei MateBook Pro now:
Also compile and run C/C++ programs on HarmonyOS Computer:
Bundled packages:
- aria2
- bash
- binutils
- busybox
- c-ares
- coremark
- curl
- elf-loader (you can run executable without executable permission! e.g.
cp /data/app/bin/bash ~/ && loader ~/bash) - expat
- fastfetch
- fish
- gcc
- gdb
- gettext
- git
- glib
- gmp
- hdc
- htop
- kbd
- libarchive
- libevent
- libffi
- libidn2
- libunistring
- lz4
- make
- mpc
- mpfr
- ncnn
- ncurses
- openssh
- openssl
- pcre2
- proot
- python
- qemu (you can run executable without executable permission! e.g.
cp /data/app/bin/bash ~/ && qemu-aarch64 ~/bash) - qemu-vroot (qemu patched to mimic proot behavior)
- readline
- sl
- strace
- stream
- talloc
- tar
- tmux
- tree
- vim
- vkpeak
- xxhash
- xz
- yyjson
- zstd
Pro tip: you can use these utilities in the builtin Terminal app under /data/service/hnp:
Although some paths might get wrong due to prefix set to /data/app/base.org/base_1.0 (thanks to @duskmoon314). You can override them like:
LD_LIBRARY_PATH=/data/service/hnp/base.org/base_1.0/lib TERMINFO=/data/service/hnp/base.org/base_1.0/share/terminfo fishYou can persist them to ~/.bashrc, and run bash before executing other commands from Termony:
if [ -d "/data/service/hnp/base.org/base_1.0" ]; then
export LD_LIBRARY_PATH=/data/service/hnp/base.org/base_1.0/lib
export TERMINFO=/data/service/hnp/base.org/base_1.0/share/terminfo
export VIM=/data/service/hnp/base.org/base_1.0/share/vim
export TMUX_TMPDIR=/data/storage/el2/base/cache
fiHowever, the builtin Terminal app does not have the permission to map R+X pages, so you cannot use elf loader there. You can use it in Termony. Also, the public folder does not get updated if you upgrade Termony. You need to re-install Termony to get the latest version available.
Terminal features:
- Basic escape sequence support
- Paste via context menu (right-click to activate)
- Copy/paste in command line via pbcopy/pbpaste using OSC52 escape sequence
- Connect your MateBook Pro to Mac, and do the following steps on Mac
- Clone this repo recursively, and cd into this repo
- Setup code signing in DevEco-Studio, ignore warnings if any
- Install
wget,coreutils,make,gsed,gettext,automake,cmake,pkg-configandncursesfrom Homebrew or Nix - (M-series User)
export PATH="/opt/homebrew/opt/coreutils/libexec/gnubin:/opt/homebrew/opt/gnu-sed/libexec/gnubin:/opt/homebrew/opt/make/libexec/gnubin:$PATH" - Run
./create-hnp.shto create hnp packages - Run
./build-macos.sh - Run
./push.sh ./entry/build/default/outputs/default/entry-default-signed.hap - Try Termony on you HarmonyOS Computer
- Connect your MateBook Pro to a Linux machine, and do the following steps
- Clone this repo recursively, and cd into this repo
- Setup code signing in DevEco-Studio, ignore warnings if any
- Setup DevEco Command Line Tools, and make sure
$TOOL_HOMEenv var is a correct directory to SDK - Run
./build-linux.sh -bto create hnp packages - Run
./build-linux.sh -sto sign the hap file - Run
./build-linux.sh -pto push and install Termony on your device - Try Termony on you HarmonyOS Computer
- Connect your MateBook Pro to a Windows machine, and do the following steps
- Install WSL (Ubuntu recomended), and build hap with following steps, like Linux
- Clone this repo recursively, and cd into this repo
- Setup code signing in DevEco-Studio, ignore warnings if any
- Setup DevEco Command Line Tools in WSL, and make sure
$TOOL_HOMEenv var is a correct directory to SDK - In WSL, run
./build-linux.sh -bto create hnp packages - In WSL, run
./build-linux.sh -sto sign the hap file - In Windows terminal, use
hdcon Windows to send and install hap file, likehdc_pushinbuild-linux.sh - Try Termony on you HarmonyOS Computer
By examining CodeArts IDE, we found that it utilizes HNP packages for native programs. You need to package .hnp files into the .hap, and add them to module.json5 like:
{
"module": {
"hnpPackages": [
{
"package": "busybox.hnp",
"type": "private"
}
]
}
}Then, you need to add the .hnp files to .hap and sign the .hap manually. You can refer to sign.py to see how it is done. The .hnp packages are unpacked under /data/app automatically and symlinks are created under /data/app/bin.