V2 Phase Documentation - swansond/LavatoryLocator GitHub Wiki

Quick Use (on Eclipse)

NOTE: Our app will load on the emulator, but a significant part of the UI won't work. This extends beyond Google Play services; we use a library called Sherlock Action Bar that the emulator refuses to load.

  1. Clone our repository: git clone [email protected]:swansond/LavatoryLocator.git
  2. In Eclipse, navigate to File->Import...
  3. Navigate to Android->Existing Android Code Into Workspace, click Next
  4. Click Browse and select the LavatoryLocator directory (which was created during the clone)
  5. Five projects should show up: choose to import LavatoryLocator, actionbarsherlock, and google-play-services_lib and click Finish. The other two projects are for our testing code, which aren't needed to run the project on the emulator.

Quick Use (on Android phone)

  1. Download our .apk file here
  2. Install the .apk
  3. Run the app.

Localization Details

  • For the most part, our code base was already set up for localization: we'd been following good Android practice and not hard-coding (too many) strings in our code, but rather referring to them in our resources directory. Thus internal changes to our code were minimal.
  • We decided to localize our app to British English (or our version of it... which is the better version).
  • You can see the pull request for this change here and here.
  • For our non-text resource, we chose to change our lavatory image (the one on the Lavatory Detail screen). You can see the relevant pull request here.
  • In order to see these changes, go to Settings->Language & Input->Language, and select English (United Kingdom).

Refactoring Details