Android Setup Guide: First-Time Subversion (SVN) Repository Tasks (part 3)

First Time Android Project Setup and Commit for SVN Repository Trunk

Only one person in your team will have to create the “skeleton” of the Android project. They will then commit it to the SVN repository’s trunk. All the other members of the team will follow the next set of instructions in order to check-out (download) the skeleton to their computer.

1. After following the previous set of instructions, you should see the “trunk” item in the “SVN Repositories” panel. It has a green up arrow as the icon to the left of it.
2. Right click on the folder you are created the project in (“trunk”) and choose “Find/Check Out As…”
3. The options you want are “Check out as a project configured using the New Project Wizard” and “Head revision”. Click “Finish” to complete this step.
4. Select “Android > Android Project” in the next screen and continue on.
5. Enter a project name and choose the option to “Create a new project in workspace”.
6. Check the box to use “Google APIs” for platform 2.3.3 (or whatever version of Android you are targeting). Click on “Next” to proceed.
7. Fill out the following page carefully! You namespace is probably “com.companyname.appname” or similar – you can make it whatever you’d like. Then click “Finish” to complete this step.
8. A new project will be created in your “Package Explorer” panel!
9. To upload this new project to the repository, right click on the project (not the SVN repo), and hover your mouse over “Team”. When the menu expands, click “Commit” and wait a little bit.
10. Review the changes, enter a brief commit log, and click on “OK” – you’re done!

First Time Android Project Checkout from SVN Repository Trunk

After one member of your team has completed the steps in the previous section, you will need to download the skeleton project that they made and add it to your Eclipse workspace.

1. After following the previous set of instructions, you should see the “trunk” item in the “SVN Repositories” panel. It has a green up arrow as the icon to the left of it.
2. Right click on the folder your team leader created the project in (“trunk”) and choose “Find/Check Out As…”
3. The options you want are “Check out as a project with the name specified” and “Head revision”. Click “Finish”.
4. The name should already be filled in with your project’s name. Click “Finish” and wait a little bit.
5. Switch over to the “Java” view by click in the >> icon in the top right of the window.
6. If you notice a red error message in the console about the Android compiler compliance level not being correct, you will have to right click the newly checked out project (not the repo), mouse over “Android Tools”, and click on “Fix Project Properties” to resolve this issue.
7. Congrats! You should now see your project’s source code in the “src/” folder!

End of Guide

This is the end of the series of guide posts for this topic on my blog! Now you will be able to begin working on your program’s code. If you have any suggestions or corrections for this series of tutorial posts, please feel free to let me know and I will update the text as necessary. If you have any questions I would suggest searching for an answer on Google. Most of the information in this tutorial can be found elsewhere online in more detail, should you need it.

Android Setup Guide: Installing and Configuring Eclipse’s Subversion (SVN) Plug-in (part 2)

Adding the Subversion (SVN) Plug-in to Eclipse

You will most likely want to use a version control system for managing the source code in your project. This set of instructions will step you through adding the Subversion plug-in to your existing Eclipse installation.

1. Start up the Eclipse IDE if you haven’t already done so.
2. Go to the “Help” menu again and select “Install New Software…” from the drop down.
3. In the “Work With” drop down, select the “Indigo” source (or whatever is the name of your release).
4. The list below will populate. Scroll up and expand the “Collaboration” section.
5. Place a check in the selection box next to “Subversion SVN Team Provider (Incubation)”.
6. Click “Next” and then click “Next” again at the confirmation page.
7. Accept the license agreement. Now click “Finish”. Wait for a bit while the plug-in is downloaded and installed.
8. Restart Eclipse when you are prompted to do so.
9. Go to the “Window” menu and select “Open Perspective” from the drop down. Then click “Other…”
10. Pick “SVN Repository Exploring” from the list and click on “OK”.
11. Place a checkbox next to “SVN Kit 1.3.5” in the next window. Then click “Finish”.
12. Click “Next” and then click “Next” again at the confirmation page.
13. Accept the license agreement. Now click “Finish”. Wait for a bit while the plug-in is downloaded and installed.
14. Restart Eclipse when you are prompted to do so.
15. You should now have a Subversion view available in addition to the normal Java view. Look in the top-right hand corner of the Eclipse window. You will see the current view, along with a small >> button to select other views.

Connecting the Eclipse SVN Plug-in to Your Repository

This step assumes you already have Subversion hosting provided to you. If you do not, you can create a free account for open-source projects through a website such as Google Code (http://code.google.com/) or SourceForge (http://www.sourceforge.net/). You can also run one on your own server, or use services provided by a hosting company to set one up. Doing this is outside the scope of this document, however.

1. When you are in the Subversion view inside of Eclipse, you should have a windows/tab called “SVN Repository Browser” located at the bottom of the screen (unless you closed or moved it).
2. In that window, right click and select “New” from the drop down menu, then click “Repository Location…”
3. If you are using Google Code, in the URL field, enter the URL http://PROJECTNAME.googlecode.com/svn/ where PROJECTNAME is changed to the unique name of your Google Code project. If you aren’t using Google Code, your Subversion host will have provided you with the correct URL.
4. Fill in the “Username” field. If you are using Google Code, this is something like YOURNAME@gmail.com.
5. Fill in the “Password” field. If you are using Google Code, your password is not your Google account password, but a different one that can be found at https://code.google.com/hosting/settings.
6. Check the box next to “Save Authentication” and “Validate Repository on Finish”.
7. Click “Finish” to complete this step.
8. Your repository should show up in the left hand side of the screen. Expand it to see the contents.

Note: Only follow the next two instructions if you do NOT want to create a specific Eclipse project for the repository you just checked out. This is likely not the case, so move on to the next part of this guide.

1. Right click on the root node of the tree (the repo URL) and click on “Check-out” to download the contents of the repo to your local workspace.
2. Now when you right click on the root node, you can go to the “Team” sub-menu which will contain all of the SVN functions such as “Commit”, “Update” and more!

Android Setup Guide: Installing the SDK and ADT Plug-in (part 1)

Installing the Android SDK

Continuing from the previous post I made regarding Eclipse, we will now download the standalone Android tools from Google. This is required to do Android development.

1. Go to http://developer.android.com/sdk/index.html.
2. Download the Starter Package installer, “installer-r16-windows.exe”.
3. Run the installer executable and follow the prompts. You will not need the installer anymore after this.
4. At the end, you will be prompted to start the Android SDK Manager. Do this.
5. The package selection screen will load. Ensure the following items and all their sub-items are completely checked:
   1. Tools
   2. Android 2.3.3 (API 10) (as of writing, this is the most widely used version of Android)
   3. Google USB Driver Package (found under “Extras”)
   4. Android Support Package (found under “Extras”)
   5. Click on the button “Install packages…” in the lower right of the window.
   6. Click on “Accept All” for the license agreement. Then click “Install” and wait a while for it to finish!
   7. Note: If for some reason you get prompted to enter a username and password, you probably selected a package that requires authentication to download. In this case you can just click “Cancel” and get on with your life.

Adding the Android Development Tools Plug-in to Eclipse

The Android Development Tools (ADT) plug-in allows Eclipse to integrate with the Android SDK and allows you to easily create, build, and debug Android projects. These instructions are copied almost directly from http://developer.android.com/sdk/eclipse-adt.html#installing.

1. Start up Eclipse. (If this is your first time running Eclipse, you will be prompted to set a workspace directory – just use the default unless you have a specific reason to choose otherwise.)
2. Click on the “Help” menu. Then select “Install New Software…” from the drop-down menu.
3. Click “Add” in the top right corner.
4. Under “Location” enter this exact URL: https://dl-ssl.google.com/android/eclipse/
5. In the Available Software dialog, select the checkbox next to “Developer Tools” and click “Next”.
6. In the next window, you’ll see a list of the 4 tools to be downloaded. Click “Next”.
7. Read and accept the license agreements, then click “Finish”. Now you must wait.
8. When the installation completes, restart Eclipse as prompted.
9. After the restart, the ADT setup window will pop up. Don’t bother to have it download the SDKs all over again, just point it at the folder you installed to previously. By default this is C:\Program Files\Android\android-sdk.
10. You can test that you have succeeded by going to the “File” menu and selecting “New” and then “Project”. If you see “Android > Android Project” in the list then you’re good to go make your first Android project in Eclipse!

Installing the Java Development Kit (JDK) and Eclipse IDE on your Windows computer

Installing the Java Development Kit (JDK)

You will need this installed before you can do anything else. If you already have the JDK installed (you can check by going to the Windows Control Panel and opening the “Programs & Features” list), you can skip this step.

1. Go to http://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. Scroll down to “Java SE 6 Update 31” and click the red download button under “JDK”.
3. Accept the license agreement and download the file “jdk-6u31-windows-i586.exe” (for 32-bit Windows) or “jdk-6u31-windows-x64.exe” (for 64-bit Windows).
4. Run the installer executable and follow the prompts, accepting default options.
5. Installation is now complete! You do not need to register. You do not need the installer after this step.

Installing the Eclipse IDE

After you’ve installed the JDK, you will need to install Eclipse. If you already have a suitable version of Eclipse installed, you can skip this step.

1. Go to http://www.eclipse.org/downloads/.
2. Download “Eclipse Classic 3.7.1” for Windows and pick either 32-bit or 64-bit depending on the version of the JDK you have installed.
3. Extract the archive “eclipse-SDK-3.7.1-win32*.zip” that you just downloaded to a folder of your choice. You will not need the archive anymore after this step.
4. Eclipse is now installed! You can run it by going to the folder and launching “eclipse.exe”.

Defeating “TrustedInstaller” with a Command Line Snippet

Here’s a little piece of code to recursively take ownership of a folder protected by “TrustedInstaller” on Windows 7.

takeown /f %1 /r /d y && icacls %1 /grant Administrators:F /t

Save this line in a .CMD file and call it with the directory you want to use it on as the first parameter. You will need to have elevated (Administrator) permission to do this properly.

FPGA/VHDL Video Tutorial Series

I’ve recently started working on an introductory level video tutorial series on digital design using VHDL and FPGAs. I have been uploading my videos to YouTube as they’re completed. I have plans to produce 11 videos in total. As I complete each video, I will update this post with the relevant links.
Read the rest of this entry »

Sealed copy of Mac OS 8.1 in original box

Darek over at Emulators.com has a bunch of classic Mac OS system software still in the sealed original boxes! He’s willing to ship them out to you as a trade for a giftcard, which covers the cost of shipping plus a little extra something for his effort. I was able to get a copy of the one version of Mac OS that I had never ran before — 8.1. Pictures are linked below.

• Front
• Back
• Bottom
• Side 1
• Side 2

Modding a DTV Converter Box into a Mini Television

I recently added a small LCD screen to one of those “free” government-coupon DTV converter boxes that I had lying around. It is an AirLink 101 model with both coax and component outputs, and runs off a 12V DC adapter. The first step taken after opening it was to find points on the board that contained the composite video signal and associated ground reference. Luckily, the 3.5mm connector was through-hole and these points were easy to locate. I also located pins for 5V and GND by probing the on-board voltage regulators with my multimeter. Thin wire was soldered onto these points. Next, I tested my work by using alligator clips to source the signals to my small LCD setup. It worked!
Read the rest of this entry »

NEZbox External Status Meter for Computers

In my opinion, one of the most useful (not to mention cool) computer mods is the addition of a character LCD to the front of a tower. On and off I’ve considered adding a small status display such as those from CrystalFontz to an empty 5.25″ bay on my computer and talking to it using a program such as the Linux LCDproc or Windows LCD Smartie, but I’ve always avoided it due to price and the idea that putting an LCD on my tower seems to be bad in terms of visibility/placement. Because of this, I decided to look into external solutions such as the $100 Lilliput Mini USB Monitor (feature overkill), or the $50 Pertelian External LCD (grossly overpriced) sold by ThinkGeek. These device have been in the back of my mind for quite some time, and it wasn’t until I stumbled across a very cool mod interfacing an analog VU meter with a desktop computer via microcontroller that I decided to proceed with building my own external status device. Thus, the NEZbox was born.

The NEZbox is a simple ATmega168-based external status meter. I put it together for about $25. The materials used include a Radioshack black plastic project box, a piece of protoboard, an ATmega168 microprocessor, 14.7456MHz crystal (not 16MHz, better for serial com), a USB-to-serial adapter (UART) PL2303 cable, a 4-line LED-backlit character LCD, a 50uA analog meter, a temperature sensor, and some wire and resistors. Later I discovered that my USB ports always stay powered even when my computer is off, so I added an small ON/OFF switch to the back. A Dremel was used to cut out slots for the meter and LCD, and epoxy glue holds them in place.
Read the rest of this entry »

Mac Plus Archive (Antique software for use with emulator)

Here is a zipped mirror of the website at http://www.rolli.ch/MacPlus/welcome.html, regarding the historical Mac Plus. It contains legacy software (System 1.1 through 6.0.8, MacPaint 1.4, MacDraw 1.9.5, and a MacPlus ROM image) that may be useful to those studying the old computer. In addition, since the original vMac project is no longer developed, the open source replacement Mini vMac may be useful to those trying to execute the aforementioned software.
Read the rest of this entry »