kutometa / cargo-armv7-android-adb-mirror Goto Github PK

This Linux container provides a mostly self-contained version of cargo that is capable of compiling and running Rust projects for armv7-linux-androideabi. This container uses the host's ADB server to automatically run compiled executables and test harnesses on connected Android devices.

This container is designed to act as a drop in version of cargo that only targets armv7-linux-androideabi. Aside from automatically injecting a --target flag and the caveats listed bellow, this container behaves similarly to cargo and and supports common usage patterns like:

CONTAINER build --release
CONTAINER run
CONTAINER test TEST-NAME

run and test sub-commands run binaries on a connect Android device without user intervention.

• By default, the container cannot access the filesystem beyond the current working directory.
• By default, Standard IO does not behave identically to native IO. See pitfalls bellow.
• By default, no caching for remote crates is preformed.

To obtain this container, you have two options:

• Obtain a prebuilt image from dockerhub
• Build the container from scratch

Dockerhub containers are tied to the version of Rust they ship. The major and minor components of the tag correspond directly to their Rust counterparts. The patch component is independent of Rust's version, and is used to reflect the version of the container instead. For example, kutometa/cargo-armv7-android-adb:1.40.1 is the second version of an image that ships Rust version 1.40.X.

Instructions on how to build the container are detailed bellow. Instructions on how to run the container follow.

This container is built on top of Debian 10 "Buster". During the build process, several remote resources must be fetched from the internet. Each of these resource are verified against a prepinned public key or a prepinned cryptographic hash.

These remote resources are:

1. Several packages from Debian's official repositories.
2. A standalone Rust toolchain installer from Rust's official website.
3. A standalone Rust library Installer from Rust's official website.
4. A standalone Android NDK installer from Google.

Before attempting to build this container, make sure that the adb server is running on the host and is listening on the default port. Also make sure that the server is properly connected to an Android device.

To build this container, you have two options. You can either use docker build or make build. If you use make, the resulting container image is automatically named kutometa/cargo-armv7-android-adb:local and tested.

Before attempting to run this container, make sure that the adb server is running on the host and is listening on the default port. Also make sure that the server is properly connected to an Android device.

If the container is built locally using docker, it can be invoked with the following command:

docker run --rm --net=host -ti \
    -v <CRATE-DIR>:/crate \
    kutometa/cargo-armv7-android-adb:local \
    <CARGO-CMD> \
    <ARGS> ...

Alternatively, if the container was built using make, a launcher script can be installed on your system using make install. Once installed, the container can be launched by running cargo-armv7-android-adb-local, as in:

cargo-armv7-android-adb-local  build
cargo-armv7-android-adb-local  test

1. When docker or adb shell is allocated a pseudoterminal (pty), an extra carriage return (U+0D) is inserted before the end of each line. Do not include -t if unmodified io streams are required.

2. No caching: No attempt is made to reuse or maintain a cargo's cache. Remote crate dependencies must be refetched each time a project is compiled.

3. This container can only target armv7-linux-androideabi and nothing else.

جميع الحقوق المتعلقة في هذا العمل محفوظة لشركة كوتوميتا لبرمجة وتشغيل الكمبيوتر وتصميم وإدارة مواقع الإنترنت (ش.ش.و). سنة النشر ٢٠٢٠.

Copyright (C) 2020 Kutometa SPC, Kuwait. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the third version of the GNU Lesser General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this work; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

• Source Repository: https://code.ka.com.kw/miscellaneous/cargo-armv7-android-adb
• Docker: https://hub.docker.com/r/kutometa/cargo-armv7-android-adb