The goal of this assignment is to get a simple, default, Android Cordova application running on your phone or on an AndroidX86 build. Preliminaries. Be sure the following installed:
sudo apt-get install lib32stdc++6 sudo apt-get install lib32z1
In general, when doing development, it can also be useful to install the C++ compiler, though it is probably not essential to this process. In particular, if you get an error saying that make is missing, then install build-essential:
sudo apt-get install build-essential
- Screen goes black. Use the Context Menu Key. The key to the left of the Right-Control key on most machines.
- Capture the mouse: The little widget in the VirtualBox menu. It works the opposite of the way you would suspect.
- Release the mouse: Right-Control once.
- Quit: Right Control - Q
More info is here
This should already have been done for you. But if you ever need to do it:
In the old days, we could download the Android SDK. Not Android Studio, just the SDK. These aren’t the old days. So download Android Studio instead.
- Download the zip file
- Unzip so that android-studio is in your home directory.
- cd android-studio/bin/
- Then start it: ./studio.sh &
When install the Android SDK, install the smallest amount possible. They are in league with various hard drive manufacturers and are trying to find ways to force you to buy a third 5 TB of storage.
This might work:
Now you can start the Android Manager:
The following is done inside the Android Manager, launched in the previous section. The goal is install the Android API verison 23.
Note: The version of the Android API that you need can change over time, but if you need to get version 24 or 22 instead of 23, it should not be too difficult to adapt these instructions to help you achieve that goal. Also note that the big danger here is installing way more than you need. Gigabyte upon gigabyte more than you need. Install as little as possible.
Install Android API 23 by doing the following:
- First un-check all Android 6.0 (API 23)
Then be sure the following is already installed:
- Android SDK Tools (Already installed)
Now prepare to add the following items by placing a check in front of them:
- Android SDK Platform-Tools
- Android SDK Build Tools
- Check Android 6.0 (API 23)
- SDK Platform
- Extras: Android Support Library
Now select the Install Five Packages button. You may get an error about failing to stop the ADB server. Since ADB is probably not yet installed, this error is expected, and you can ignore.
Create a project
Go to your repository and do the following
cordova create Week01-CordovaStarter cd Week01-CordovaStarter cordova platform add android cordova build android
If Cordova is unknown, then do this:
npm install -g cordova
If your build fails like this:
:CordovaLib:processDebugResources FAILED FAILURE: Build failed with an exception. * What went wrong: Execution failed for task ':CordovaLib:processDebugResources'. > java.io.IOException: Cannot run program "/home/bcuser/Android/Sdk/build-tools/22.0.1/aapt": error=2, No such file or directory
You might be able to fix it with these commands, which were mentioned earlier:
sudo apt-get install lib32stdc++6 sudo apt-get install lib32z1
To connect to your Android X86, do the following:
- adb connect [YOUR IP from netcfg]
NOTE: We use the netcfg command on AndroidX86 in order to see the IP address of the device. In particular, go to the application page and run the Terminal Emulator. All this is described in more depth in the AndroidX86Install assignment.
Suppose the IP address you found in the terminal on AndroidX86 was 192.168.1.2. Then you would type this on your Linux box to establish the connection:
adb connect 192.168.1.2
To confirm that it worked, you can can ask adb to display your connections:
For instance, here is a sample run of both adb connect and adb devices:
charlie@forestpath:~/temp/Week01-Foo $ adb connect 192.168.2.33 connected to 192.168.2.33:5555 charlie@forestpath:~/temp/Week01-Foo $ adb devices List of devices attached 192.168.2.33:5555 device
adb install [YOUR APK file]
A bit like this, perhaps:
$ adb install platforms/android/build/outputs/apk/android-debug.apk 10208 KB/s (1822587 bytes in 0.174s) pkg: /data/local/tmp/android-debug.apk Success
NOTE: An APK file contains your project. You can think of an APK file as an executable, as a program. It is really just a compressed file with your project inside it. If you install “Google Drive” on your phone, or if you install a computer game on your phone, then you are installing an APK file. The game comes in an APK file and your app comes in an APK file.
To uninstall your project:
- adb uninstall [URL of your APP from config.xml in project root]
Perhaps something like this:
$ adb uninstall io.cordova.hellocordova Success
You must uninstall an existing APK before you try to update it. In other words, you can’t copy your APK file over an existing APK file on a phone or on AndroidX86. Instead, you first uninstall it, then install your updated copy.
Edit the H1 element in www/index.html to include your last name. Rebuild the application and reinstall it.
Push to Your Repository
This part of the assignment is optional for now. If you have not done so already, create a private repository on BitBucket or Github.
Use this naming scheme:
Push your work to the repository.
Information on SSH is here:
Be sure to share the repository with me. I’m ccalvert on BitBucket and charliecalvert on GitHub.
Turn it in
Submit a screen shot of your Cordova project running in Androidx86 inside VirtualBox.
Be sure that:
- Your name is visible in the application in the H1 tag of your www/index.html file.
- The DEVICE IS READY bar is green.
- The VirtualBox chrome is visible. For instance, the words Oracle VM VirtualBox should appear at the top, and the icons near the words Right Ctrl (or the MAC/Linux equivalent host key) are visible on the bottom.
Here is the body of index.html, with the place where I want to see your name called out in square brackets:
You need not write APACHE YOURNAME. It can be YOURNAME CORDOVA or whatever (within reason) strikes your fancy, so long as it is in the H1 tag and it contains your name.
Commands to remember:
- cordova create Week01-Test com.lastname.test_lastname IsitTestCalvert
- cordova platform add android
- cordova build android
- adb uninstall io.cordova.hellocordova
- adb install platforms/android/build/outputs/apk/android-debug.apk
- cordova create Week01Test com.elvenware.test_calvert IsitTestCalvert
- cordova create [Directory] [URL] [Name]
If you save the following in the root of your project folder as install, then you should be able to automate this process:
#! /bin/bash cordova build android adb uninstall io.cordova.hellocordova adb install platforms/android/build/outputs/apk/android-debug.apk
Then make it executable:
chmod +x install
To run it, type this:
We’ll discuss in class on Monday.
To try using your phone instead of AndroidX86, see this
This is outdated. Ignore it:
- Decompress the archive with a command similar to this:
- tar xvfz android-sdk_r24.4.1-linux.tgz
- Move the archive to the ~/Android directory
- mkdir ~/Android
- mv android-sdk-linux/ ~/Android/Sdk