Archives/NanoDroid
2
0
Fork 0
mirror of https://gitlab.com/Nanolx/NanoDroid synced 2024-10-31 09:20:23 +00:00
Code Issues Projects Releases Wiki Activity
2156f9355b
NanoDroid/README.md
Christopher Roy Bratusek fd585f3ec7 A11 status update
2020-11-02 16:55:05 +01:00

10 KiB
Raw Blame History

Table of Contents

Created by gh-md-toc

NanoDroid

NanoDroid is a installer for various OpenSource related things, most noticably microG and F-Droid. It supports direct /system installation, both devices with or without A/B partition scheme or system-as-root, aswell as Magisk Mode (module) installation. It also includes several tools (eg. GNU Bash, tools from util-linux/bsdmainutils and more) and additional features (system debloating, init scripts, automatic logcat creation), aswell as a companion F-Droid Repository.

Furthermore it allows the user to do fine-graded installations using configuration files, which allow to choose what to install, or if several alternatives are available, which of them, see Installation below.

In order for full microG experience NanoDroid contains a modified Play Store which allows (in-)app-purchases with microG, which would normally not be possible. It also tries to remove all previously installed GApps on it's own. For ROMs without builtin signature spoofing support NanoDroid includes an on-device Patcher which tries to patch your ROM from either TWRP or Magisk Manager.

Versions until 15.1 were called NanoMod, starting with 16.0 they're called NanoDroid.

Current Release

  • Stable: 23.0.1.20201029 "FCK 2020"
  • Beta: ---

Downloads

Primary Mirror

On Nanolx the latest stable and current beta releases are available, no previous releases.

SHA256 Checksum and GPG Signature

Since version 18.3.1 all releases hosted on nanolx.org contain a SHA256 checksum and GPG signature to check their validity. AFH does provide the SHA256 checksum on the downloads summary page, but does not allow to upload a GPG signature.

You can obtain the public part of my GPG key from:

  • download the public key from photonic.asc
    • import it using gpg --import photonic.asc
  • download and import using gpg from pgp.mit.edu:
    • gpg --keyserver pgp.mit.edu --recv B0ABCE622A077B584B81339E340FD70EFFC52B26

You can verify the checksum and signature like:

gpg --verify NanoDroid-19.0.20181027.zip.sha256.sig
sha256sum -c NanoDroid-19.0.20181027.zip.sha256

Additionally you may want to ensure the signing date is close to the release date.

Snapshots

You can create snapshots from this repository using the build-package script.

See the build-package documentation for more information.

Custom builds

The following applications are custom builds (see F-Droid Repository below):

Supported Android Versions

NanoDroid officially supports the following Android versions:

  • 4.4 / SDK 19 (KitKat)
    • System Mode only (Magisk does not support KitKat)
  • 5.0 / SDK 21 (Lollipop)
  • 5.1 / SDK 22 (Lollipop)
  • 6.0 / SDK 23 (Marshmallow)
  • 7.0 / SDK 24 (Nougat)
  • 7.1 / SDK 25 (Nougat)
  • 8.0 / SDK 26 (Oreo)
  • 8.1 / SDK 27 (Oreo)
  • 9.0 / SDK 28 (Pie)
  • 10.0 / SDK 29 (Q)
  • 11.0 / SDK 30 (R)
    • Patcher does not work from TWRP
    • Patcher works from Magisk if your ROM's services.jar already contains classes.dex

Earlier versions will never officially be supported (you may still report bugs, though). Future versions will be officially supported, eventually.

Recommended Thirdparty Projects

  • busybox by Osm0sis (highly recommended for all NanoDroid scripts properly working)
  • GNU Nano editor by Osm0sis (simple, powerful commandline editor)

Support

> XDA Support Thread

ChangeLog

Full, user-readible > ChangeLog

Summary

NanoDroid can be installed as a Magisk Module or directly to /system, most functionality is available, in System Mode, too.

More information about Magisk > XDA

NanoDroid includes

  • microG and it's companions
  • > F-Droid and it's privileged extension
    • alternatively you can install > Aurora Droid and it's services extension
  • modified Play Store to allow (in-)app-purchases with microG
    • this required the Play Store to be modified, see the > patch
    • alternatively > Aurora Store and it's services extension can be installed instead
  • custom init scripts
  • pseudo-debloat feature (Magisk Mode)
  • force-debloat feature (Sytem Mode)
    • moves applications out of the way to /data/media/0/nanodroid_backup/
    • pre-configured > default settings
  • several Open Source applications
  • on-device framework-patcher for microG support (signature spoofing)
    • with automatic de-odexing up to Android 8.1
  • additional components
    • GNU Bash shell (with Less pager)
    • Addon.d support for System Mode installation
      • restores NanoDroid after ROM update
      • re-debloates GApps, if required

Packages

See the Packages summary for information about the available packages.

F-Droid Repository

In order to ease updating NanoDroid's custom application builds you can use it's companion F-Droid Repository

Details

See the > Detail information for full details on microG, F-Droid, features and utilities included with NanoDroid.

Installation

See the Installation docs for instructions

microG Setup

See the microG setup documentation

Issues

See the list of known issues and their respective fixes or workarounds.

License & Credits

My own work (NanoDroid itself) is licensed under the GNU General Public License version 3 or newer > GNU

For more details (including authors and license) on every provided application or Software press the link next to it.

Additional credits go to

Special Thanks to the contributors (starting with most recent contribution)

  • TanyaEleventhGoddess
    • various improvements and fixed for build-package
  • Gia90
    • Android 6.0 support for Patcher
    • fixes for x86_64 support
  • Vavun
    • OsmAnd package
    • several contributions to NanoDroid (and it's former microG GmsCore fork)

Special Thanks to the beta testers

  • xenithorb
  • ShapeShifter499

TODO

FAQ

Q: will there be a GApps version, instead of microG?
A: no. but you can choose not to populate microG.

Q: what devices is this tested on?
A: OnePlus 5T, OnePlus 3T, Nexus 6

Q: what ROMs was this tested on?
A: AICP, OmniROM, NitrogenOS; should work on any LineageOS / AOSP based ROM and most Stock ROMs.