thomasballinger / hsfacesandroid

This is a port of the HSFaces app to Android.

HSFaces Android App

This is a port of HSFaces project. It's a memory game and Hacker School directory for former and current students.

How it works

On begin, you must login with your Hacker School email and password. This then scrapes the Hacker School website, downloads all the data for each Hacker School student and saves it to a SQLite database on disk. Note that if you clear out the data for the app, you'll have to go through the set up process again. When a new batch is added, there is an option for refreshing the data from online. Past data is not updated unless all data has been cleared out.

Initial load is quite lengthy (due to XPath processing. This could use some optimization). Most of it is in app processing, not data downloaded from the network.

Images are stored locally in internal storage. This could probably use some more error checking (esp if there's not enough disk space). Offline play uses only the images that are already stored locally.

Game Play

Users are shown a randomly selected subset of all Hacker Schoolers. After a set number of guesses (41 at the moment), the game ends.

Browsing for a Hacker Schooler

This app also provides a directory of Hacker Schoolers. It's sorted (at the moment) by batch, then name. If they've provided it online, this allows you to visit their github, twitter, or email from within the app. You can drill down to see more details for each Hacker Schooler.

Onward and upward

Proposed future work

• Use disk based cache for images / allow for 'offline' play
• add some more custom styling to fonts
• Give users option to play by batch
• Store user login data (if requested) and high score
• Display current user's image after they've logged in
• User & skill search
• Add spinner for loading icons
• Add batch headers to the list view
• Style toasts to for Correct and Wrong
• animations for win
• Faster XML parsing
• Better tablet design for list and drill down
• Keep list of common nicknames

How to build

1. Install Android Studio
2. In Android Studio use the SDK Manager (button in toolbar or in menu under Tools -> Android) to install Android Support Repository, Google Repository (in Extras) and sources for API 18 (or one supported by your device)
3. Open (not import) the project in Android Studio
4. Copy over local.properties.sample to local.properties, edit if you installed Android Studio in a different location
5. "Sync Project with Gradle Files" (button in toolbar or in menu under Tools -> Android)
6. Run project (button in toolbar or in menu under Run)

Contributions

Pull requests welcome! Most of this is undocumented, send me a note if anything's super unclear.

Due Diligence

Commonsguys' SQLiteCursorLoader that's been reimplemented in this app.