Key Points

1. a relatively open source mobile OS ( vs Apple )
2. easier to customize the Apple
3. Options to install, run Linux desktop OS on Android

References

Key Concepts

Android Debug from Windows or Mac using adb.exe

use google adb.exe tool

the process is a little work if you want to try.

https://pruvan.zendesk.com/hc/en-us/articles/202717265-How-to-get-an-Android-System-Log

basically there is a tool called ADB that can pull the log file from the device once you have it connected to your laptop for example.

How to get an Android System Log

Sometimes there's a hardware issue that is specific to a single device or a device model that we can not reproduce in our office. In these situations we will need a system log from the device that...

i can try to get you a log if you need one too from our cloud provider. i just need the exact device and OS version of Android and what build you want me to try

Sometimes there's a hardware issue that is specific to a single device or a device model that we can not reproduce in our office. In these situations we will need a system log from the device that is having the problem to try and figure out what is going wrong. These instructions can be used to create that log and send it to us.

1. Install your device driver

• Your device driver should install when you connect your device to the computer over USB. If it does not you may need to locate and install the driver from your manufacturer's website. Once you get to Setup the Log step 7 (6 for Mac) you will know if you need a different driver.
  
  ( For Samsung Note 8 I had to manually search the Web for the right USB debug driver. )

2. Connect your device

1. Plug in your device via USB to your computer

2. Go to your Settings app

3. Scroll down to the bottom and tap on Developer Options

   • If this option is not there then:

     1. Scroll down to the bottom and tap on About Phone (or Device)

     2. Scroll down to the bottom and tap repeatedly on Build Number

        • Stop once the message says you've unlocked Developer Mode

     3. Tap back

4. Make sure Android Debugging is checked

3. Setup the log

Windows

1. Download Platform-tools from Google

   • Windows - http://dl-ssl.google.com/android/repository/platform-tools_r20-windows.zip

2. Create a folder in your C drive called 'adb'

3. Unzip the Platform-tools zip file to this folder

4. Press the win+r on your keyboard

5. In the run window type cmd.exe and press enter

6. in the CMD window type 'cd c:\adb' and press enter

7. Type '
   adb devices
   ' and press enter

   • This should write a line to the CMD window that says '009ab325109378df7e device' or something like that

   • If it says that there aren't any devices, then you need a different device driver

8. Type '
   adb logcat > android.log
   ' and press enter

   • This will just show the cursor (blinker) sitting on a new line (with no 'C:\adb' in front), blinking. This is good.

Mac OS

1. Download Platform-tools from Google

   • Mac OS - http://dl-ssl.google.com/android/repository/platform-tools_r20-macosx.zip

2. Create a folder in your hard drive called 'adb'

   • This will be next to folders like; 'users', 'applications', 'system', etc..

3. Unzip the Platform-tools zip file to this folder

4. Go to the Utilities folder and run Terminal

5. in the Terminal window type 'cd \adb' and press enter

6. Type 'adb devices' and press enter

   • This should write a line to the Terminal window that says '009ab325109378df7e device' or something like that

   • If it says that there aren't any devices, then you need a different device driver

7. Type '
   adb logcat > android.log
   ' and press enter

   • This will just show the cursor (blinker) sitting on a new line (with no '\adb' in front), blinking. This is good.

4. Recreate the issue

1. Pick up your device

2. Open the your app to test

3. Take photos or do what every you need to in the app to create the error(s)

5. Finish up

Windows

1. Click inside of the CMD window on your computer

2. Press ctrl-c

   • This will stop the log

3. Open a folder on your computer and go to C:\adb

4. Attach android.log to a reply email for your open ticket

Mac OS

1. Click inside of the Terminal window on your computer

2. Press cmd-c

   • This will stop the log

3. Open your hard drive and go to the adb folder

4. Attach android.log to a reply email for your open ticket

Find USB debug drivers for different phones

Get USB debug driver for a phone if it didn’t automatically download on Windows USB connect

best site for Note 8 USB driver install

https://www.mobileheadlines.net/samsung-note-8-usb-driver/

Potential Value Opportunities

Ubuntu Options for Android devices

Options to Work on Hyperledger from an Android Phone

Option 1 - Use VNC client for Android and connect to an Ubuntu server

https://play.google.com/store/apps/details?id=com.realvnc.viewer.android&hl=en_US

or the free option

https://play.google.com/store/apps/details?id=android.androidVNC&hl=en

The server can be a local system, in your network or in the cloud

Pros:

1. Simple to install and configure to any VNC server
2. Works without changing your phone configuration, data or encryption

Cons:

1. You need a VNC Connect account at RealVNC or use the optional VNC viewer above
2. You need an Internet connection to access your remote server

Option 2 - Install Ubuntu server on your Android phone

Technorm notes to install Ubuntu server on Android phone
https://www.technorms.com/12451/install-ubuntu-on-android

or the free deployment tool option below

Maketecheasy article to install Ubuntu on Android with Linux Deploy
https://www.maketecheasier.com/install-ubuntu-on-android-linux-deploy/

Install Ubuntu server on your Android device

Pros:

1. No cost - just suggested donation
2. Full Ubuntu server runs anything on your phone ( including Hyperledger Fabric in theory )

Cons:

1. Many - root the phone
2. Complex install and support
3. May require phone factory reset deleting apps, data and encryption
4. Requires VNC server and client running to access Ubuntu desktop
5. Requires high-end Android phone on new version of Android ( at least 8 GB memory )
6. The Linux installer may be billable depending on which installer you choose
7. No guarantees on the stability of Linux on Android

In my case, I run Ubuntu in Oracle VirtualBox on a Windows 10 PC fine.

I allocate 6 GB memory to Ubuntu and that is more than enough to run Hyperledger Fabric in a developer environment

Developers - Run Ubuntu server on Android - Options

Using a pre-made Ubuntu image, your phone creates a running version of Linux. There’s not much installed and it runs on LXDE to make sure everything fits within the phone’s memory. However, it is very much a legitimate copy of Linux.

The catch is that you can’t actually see Linux when it runs. The process is contained within an invisible set of programs that is not visible above the Android OS. In order to actually see Ubuntu in action, you need to use a VNC server app.

Ubuntu on Android - Ubuntu docs

https://docs.ubuntu.com/phone/en/devices/installing-ubuntu-for-devices

Warning - Do NOT use Ubuntu Touch option !! You want NORMAL Ubuntu and VNC access to the desktop

Warning: data loss of Android Apps, Data !!

Installing Ubuntu for devices deletes all data (including applications and data such as contacts, photos, and etc.) from the device.

An optional procedure is provided below that backs up the Android apps and data to a local file. There is no guarantee that a restore will succeed.

Warning: Must remove encryption and do Factory reset on phone !!

Warning: If your device is encrypted you must perform a full factory reset before installing ubuntu. This also will delete all data from the device, including apps and other data. You may want to create a backup first. You can perform a factory reset via the settings screen

Unlock the Android device ...

https://docs.ubuntu.com/phone/en/devices/installing-ubuntu-for-devices#unlock-the-android-device

Technorms article - Install Ubuntu on Android with Complete Linux Installer tool

https://www.technorms.com/12451/install-ubuntu-on-android

Use Complete Linux Installer tool - a billable software tool

https://play.google.com/store/apps/details?id=com.zpwebsites.linuxonandroid

With a root and a very large amount of storage space on the SD card, you can actually run a low-end version of Linux right there on your Android device. Seriously. This ingenious hack theoretically allows for several different versions of Linux, but we opted to go for Ubuntu. Believe it or not, it actually worked.

Install Ubuntu on Android

Background

Ubuntu can be installed on an Android phone by ingeniously linking two different apps within the same device. Fair warning: this hack is not intended for low-end Android phones. The app recommends at least 1 GHz of processing power. We also overclocked our phone with Tasker for the duration of running Linux.

Here’s what happens. Using a pre-made Ubuntu image, your phone creates a running version of Linux. There’s not much installed and it runs on LXDE to make sure everything fits within the phone’s memory. However, it is very much a legitimate copy of Linux.

The catch is that you can’t actually see Linux when it runs. The process is contained within an invisible set of programs that is not visible above the Android OS. In order to actually see Ubuntu in action, you need to use a VNC server app.

VNC (virtual network computing) is used for remotely viewing another PC over a network. You can use a basic VNC app to view the local OS, which in this case is Ubuntu. With those two apps linked together, Linux runs right there on Android.

Materials Needed

• A Nandroid backup
• A kernel that supports loop devices. Unfortunately, there is no way to check for this other than trying the installation. If you run up against a seemingly insurmountable wall, this may be the issue.
• Root access (duh)
• Busybox. Download the app Busybox Installer and use it to install the latest version of Busybox. You may have to run the installer twice to make sure that it really installs.
• Enable USB debugging. Go to Settings > Apps > Development and check the box for debugging.
• A solid Wi-Fi connection. You’ll download a lot of files, and it’s best to not do it over data.
• Storage space. The Ubuntu image requires 2.5 GB, but it’s best to have 3.
• A file browser app that can unzip compressed files. Astro File Manager does this and is free.
• VNCviewer
• Android Terminal Emulator
• Try Complete Linux Installer – Ubuntu Installer Free is no longer available.

Installation

The first step, as always before any serious Android hack, is to reboot into recovery and make a Nandroid backup. This step is absolutely critical and should never be skipped. If something happens and messes up your phone, that backup is the only safeguard.

Now open the Ubuntu Installer Free app. It will contain instructions as well for installing. Tap “Install Guide." Check that you’ve followed all the instructions listed and hit next.

In order to run Ubuntu, you need two critical files, the boot script and the image. The “large" Ubuntu image is an extra 1 GB but comes with more programs already installed. We chose the “small" one simply because you can always install more programs later. However, you will need the boot script no matter which image you pick.

Download these files. It will take a while, so find something else to do. Water a plant. Paint a sunset. Or just watch Battlestar Galactica reruns on Netflix. Guess which one we did?

When everything has downloaded, open up that file browser and create a folder labeled “ubuntu" (without the quotation marks) in the root of the SD card. Cut and paste the boot script and image into this new folder. Extract the contents of both files into /sdcard/ubuntu. This too will take a while.

Now exit the file browser and go to the Terminal app. We recommend switching off any sort of autocorrect feature you might have for your keyboard. Linux text commands are not grammatically correct by any stretch of the imagination and certainly did not play nicely with our autocorrect in Perfect Keyboard.

Type these commands (hit enter between lines and grant Terminal root access when it asks):

su

cd /sdcard/ubuntu

sh ubuntu.sh

Next Terminal will ask for your screen size. This can be found by searching “(phone model) specs" on Google. Our original HTC Evo 4G has a resolution of 800×480, so we input “800×480" (with no quotes) and hit enter.

A lot of text should scroll by at this point. If all works out, the text will end with a message saying “root@localhost:/#". This means that Linux is up and running. If it doesn’t say that, double check that Busybox is installed. We ran into that issue.

Congratulations! Ubuntu is now running. You may not be able to see it, but it’s running. The Terminal app now functions as the command line for the OS. The in-OS command prompt app does not work.

In order to actually see your brand new OS, open the Android VNC app. Set the IP address to localhost. The port number should already be 5900. Put in the password as “ubuntu" (no quotes). Skip the username section and set the color format to 24-bit color. Once all that is set up, tap connect.

Linux should now appear in all its LXDE glory. To exit at any time, type “exit" (no quotes, as always) into Terminal.

Life After Installation

The first and most obvious problem is that Linux is a desktop OS, definitely not something meant for touch screens. Tap menu and change the control scheme to touch pad, which makes the touch screen function as a basic mouse. The controls are by no means perfect, but they work.

To be honest, this hack works best on tablets. We really struggled to use Linux on our microscopically small phone screen. Even with an easy zoom function, Ubuntu is not easy to use. Side note: To input text, hold down the menu key. That brings up a virtual keyboard. However, we could easily see someone using a physical keyboard and a tablet with this hack in order to make a facsimile desktop PC.

Final Thoughts

It’s not too difficult to install Ubuntu on Android, and it’s certainly not the friendliest of OSes (even by Linux standards), but it is pretty damn neat. Not to mention that all the things normally restricted on mobile devices (like Hulu, The Daily Show and Spotify) are now fair game. No doubt hardcore geeks will find some creative uses for this hack.

Maketecheasy article - Install Ubuntu on Android with Linux Deploy

https://www.maketecheasier.com/install-ubuntu-on-android-linux-deploy/

Uses Linux Deploy a free Linux installer for Android.

https://play.google.com/store/apps/details?id=ru.meefik.linuxdeploy

It’s easy to forget that Android is a Linux-based operating system sometimes. But it is, and it retains some of that openness and flexibility that attracts people to the Linux platform.

As an example, you can actually install a full Linux distro on your Android device. We’ll demonstrate how to install Ubuntu on Android using an app called Linux Deploy, which will install the Linux desktop environment, but you can use this same method to install Debian or various other Linux distros.

Note: you’ll need to root your Android device before starting this process.

Install and Deploy Linux on Android

First, install BusyBox. This is a toolkit that unlocks your Android phone for various Linux commands that are essential to getting Ubuntu up and running. You won’t need to actively use this after installing it.

You’ll also need VNC Viewer, a remote desktop app that creates the window within which Ubuntu will run on your Android device. This is what you’ll ultimately be using to get Linux up and running.

Finally, you need to install Linux Deploy, which you’ll use to install Ubuntu (or one of several different versions of Linux, for that matter).

After installing Linux Deploy, open it and tap the icon with the three sliders (bottom-right corner).

Here you can select the Linux distro you want to install. (Just tap “Distribution,” then select the distro name – we went with Ubuntu.)

After that, scroll to the GUI section at the bottom, tap the “Enable” box and make sure “VNC” is selected under “Graphics subsystem.”

Once you’ve done that, you can also go into “GUI Settings” to set the resolution of Linux once it runs. Unless you have a tablet, the default 1920 x 1080 resolution on most smartphones is probably too high to practically use Linux, so we recommend lowering it to 1024×576 or 1152×648.

Finally, scroll back up about halfway until you find “User name” and “User password.” Make a note of them, or replace them with your own.

Those are all the settings you need to tweak. Go back to the Linux Deploy home screen, tap the three-dotted menu icon at the top-right and tap “Install.”

The installation may take from one to several minutes, depending on the speed of your smartphone.

Once it’s finished (denoted by the “<<<deploy” message at the bottom of the install log), tap Start at the bottom-left corner, then “OK.” Once you see the message “<<< Start” at the bottom of the log, Linux is deployed and running.

Run Linux on Android

But in order to actually see and use Linux, you need to use VNC Viewer. Open VNC Viewer, tap the green “+” icon at the bottom-right, then in the “New connection” box enter “localhost” as an address, and give the connection a name of your choice. (We went with “Linux.”) Click “Create.”

Tap the new connection in VNC Viewer to open it, and your Linux build should open up!

It won’t have anything installed on it by default, but you can go to the Terminal and sudo apt-get install various software like you normally would in Linux.

Conclusion

That’s it. You now have a fully functional Linux distro on your Android device.

If at any point you decide that you don’t want Linux any more, it’s not a case of uninstalling Linux Deploy. Instead, you’ll need to use a file explorer with root access (we used Root Browser), find the directory “/data/user/0/ru.meefik.linuxdeploy/env” and delete it. (You can change the default Linux install directory in Linux Deploy’s settings menu).

Run VNC Server on Android or on Ubuntu on Android

https://www.realvnc.com/en/connect/download/viewer/android/

You can also use Google Play to download this app to the phone.

Download VNC® Viewer to the device you want to control from, below. Make sure you've installed VNC® Server on the computer you want to control.

You can also run the VNC client on Android as well.

This allows you to access a Linux OS Desktop running from your Android device in theory.

You run VNC server for Linux on Ubuntu

You run VNC client on Android or Ubuntu

In theory you have access to the Ubuntu Deskop via the VNC client app

Potential Challenges

Candidate Solutions

Step-by-step guide for Example

sample code block

Recommended Next Steps

Related articles