devnebula / android_development_shell_tools Goto Github PK

'android_development_shell_tools' is a project I started in 2015
to ease Android development, ADB usage, Git commands and related projects.
Originally a private set of scripts, I made the project evolve towards
a publically shareable set of tools that can be easily used and even configured
by anyone interested in using advanced development tools and in winning time.
It provides many functions and shortcuts to ease Android development.

The sources written and shared here are either meant to be used as they are,
or to serve as a reference for commands and functions an Android developer needs.
Developers or beginners interested in Shell commands and scripting
can look into my sources and find documented commands and syntaxes,
which can be used as a reference of Shell scripting and help making their own.

To keep a local sync of 'android_development_shell_tools' updated with upstream changes,
simply run the shtoolssync; command and the updates will be downloaded.
Local modifications will be lost through the update (read about git stash pop in that case)
and the newest commits / improvements will be added to your available tools.

If you intend to keep personal or unfinished functions along this project,
you can also look at the shell_users branch, a minimal variant
that allows holding functions or macros separately (like credentials).

The linked documentation holds a reference point to all functions and macros
that this project provides, which details their purpose, and if present,
details the <required> or [optional] parameters available.

The documentation is completely dynamically built, through a function I wrote
to parse the whole project and to create this unique reference point.
Functions and macros seen there will exist as presented in the documentation,
there is no risk of irregularities between the list and the actual sources.

Scripts flagged "Standalone Import Ready" and starting with source <(curl -Ls...
are able to be directly sourced through the provided commands in any terminal
without the need of this project being synced locally or loaded in the Shell.
This can be useful when using a different computer, when running from a root Shell,
or even if you need a few functions for work to ease something.

The "extensions/" folder can hold self-coded scripts folders based on the scripts from
'android_development_shell_tools' and be included along the regular ones.
These scripts will not be lost with 'shtoolssync' and will stay in "extensions/".
(Keeping a copy or symlinking extensions scripts is recommended for safety)
If the new extension is generic enough for public use or interest,
I can easily consider merging it in the common upstream sources.

First, you need to clone this project locally
git clone https://github.com/AdrianDC/android_development_shell_tools -b master;

To load the scripts, do source /path/to/folder/android_development_shell_tools.rc;

To permanently load the scripts in your Shell terminals,
open the ~/.bashrc file, adapt and add the following lines:

export ANDROID_DEV_DRIVE=/media/../AndroidDev;
source "/.../android_development_shell_tools.rc";

The ANDROID_DEV_DRIVE variable is a reference folder I use
for all Android projects, repositories, kernels and ROMs.
You do not need it, but a few functions rely on it to ease things.

Perform the scripts modifications, fixes or additions.

Update README.md documentation with shtoolsreadme;.

Commit the changes with git (refer to older commits for style)

Push your changes and create a pull-request once ready