Android

Also see Rooting Android

This page has got some info on how I use my Android phone.

Installing Android SDK

Mac OS X

Download android-sdk_r10-mac_x86.zip from here: http://developer.android.com/sdk/index.html

Extract to wherever you want, I put it with the rest of my 3rd-party packages in ~/pkg. It's a binary, so you can just extract the .zip file and put it anywhere.

You'll want to add the location of a couple of utilities to your $PATH, by adding this to your .profile or whichever dot file you put your $PATH stuff into (or just by running these from your command line, if this is a one-time thing for you):

export PATH="${HOME}/pkg/android-sdk-mac_x86/platform-tools:${PATH}"
export PATH="${HOME}/pkg/android-sdk-mac_x86/tools:${PATH}"

You can test it worked right by running:

$ which adb
/path/to/android-sdk-mac_x86/platform-tools/adb

$ which android
/path/to/android-sdk-mac_x86/tools/android

This doesn't come with all the things you'll need, so before doing anything else, run the "android" program, which will run the Android SDK Manager.

I recommend installing the following:

• SDK Platform Android (whatever the latest API is)
• Android SDK Platform-tools
• Android SDK Tools

Pick "Available packages" from the side bar and then collapse the various lists there. You'll find the above packages in the list.

If you try and collapse the list and you see a "Failed to fetch URL (blah blah blah)", then pick "Settings" from the side bar and check "Force https://... sources to be fetched using http://...".

Windows

1. Extract the HTC_Droid_Incredible_Root.zip file to a folder with the same name

2. Open the folder and launch HTCSync2.0.25.exe and complete the installation

3. Copy the sdk directory into the root of the C drive, in C:\sdk

4. Open C:\sdk and run SDK Setup.exe

a) you may get an error about https, if you do then close the window with the error message and click "Settings" on the left-hand side, then check the box that says Force https:// sources to be fetched using http://)

b) you may also need to update the version of the Tools. Click on "Available Packages" on the left-hand side of the "Android SDK and AVD Manager" window, and then check the "Android SDK Tools" box, and then click "Install Selected".

5. Go back to the unzipped HTC Droid Incredible Root folder and open command.txt

6. Open a Windows command prompt (Start > Run > "cmd")

7. Change directory to C:\sdk\tools by running

> cd\
> cd sdk
> cd tools

Internet Tethering

You can get internet tethering for free using a program called Proxoid (http://code.google.com/p/proxoid). It creates a proxy service, so that all internet requests from the computer are forwarded (via USB) to the phone, and the phone then forwards the request to The Interwebs.

This literally took me 30 seconds to set up. It's very, very simple if you've got the right tools.

1. First, you'll want the Android SDK kit, because you'll use it to send instructions to the phone. See #Installing Android SDK above.

2. Enable USB debugging on your phone: Settings > Application > Development > Enable USB Debugging

3. Open the Proxoid application on your phone. I'll assume you're using port 8080, but change it to any port you want.

4. Run this command to tell your phone to handle tcp traffic from your local computer to the Android phone:

$ adb forward tcp:8080 tcp:8080

Now, when your computer sends requests via port 8080, your phone knows how to handle it correctly.

You will need to run this command every time you want to use Proxoid!

5. Set proxy settings on your local machine so that IT knows to send requests via port 8080. See next section.

Setting Proxy Settings

You can do this a couple of different ways:

Proxy Option 1: Browser Only

Most modern browsers allow you to set proxy settings that are specific to the browser. I use (and recommend) Firefox, but other browsers will work too. First, pick Firefox > Settings > Advanced, and pick the "Network" tab:

Click "Settings", and Firefox will allow you to configure proxy settings. You want to configure the proxy to be localhost and the port to be 8080:

In normal-people speak, this tells your computer to route all internet requests through port 8080 of the local machine. Then, any requests to port 8080 are handled by the phone (well, by Proxoid) becuase of the "adb forward tcp:8080 tcp:8080" command you ran above.

Proxy Option 2: System-Wide

Still working this one out.

Proxy Option 3: SSH Tunnels

You can use a utility called Corkscrew available here: http://www.agroman.net/corkscrew/

Alternatively, you can use the ProxyTunnel utility available here: http://proxytunnel.sourceforge.net/

You can combine this tool with SSH tunnels to redirect traffic from any port through an SSH tunnel.

Following the Proxoid Linux users guide (http://code.google.com/p/proxoid/wiki/installationLinux), you can point SSH to the Corkscrew command by adding the following to ~/.ssh/config:

ProxyCommand /usr/local/bin/corkscrew localhost 8080 %h %p
ServerAliveInterval 10

Note that this will work even when SSHing to non-standard ports. If you run "ssh -p 12345 user@host", then it will pass "host" to "%h", and "12345" to "%p".

The ServerAliveInterval is required, because otherwise SSH connections will be closed after around 30 seconds. This sends a "keepalive" packet to the server every 10 seconds.