Skip to content
Refugee Services of Texas relocation checklist
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
app
bin
docs
gradle/wrapper
.gitignore
CONTRIBUTING.md
LICENSE
PRIVACY.md
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

RST Checklist App

RST Checklist app logo

This app helps refugees in central Texas by providing them a checklist of resettlement TODO's and notifications from Refugee Services of Texas (RST).

Try it out

Download RST Checklist on the Play Store.

Screenshots of the app's welcome, checklist, and checklist item activities

We've been using the latest 2.2 version of the canary channel of Android Studio to develop, so if you want to hack on it, it's probably easiest to download that, clone the project, and run the app. If you're on a stable channel, you may need to tweak the com.android.tools.build:gradle dependency version in the top level build.gradle.

Translations process

We need translations in two areas of this app:

  1. The Android-standard strings.xml resource files
  2. The Firebase database used to store the checklist items. This file is mirrored in the source

To streamline the process, we've got a little script to get a CSV of the translations:

stringtool.py tocsv > strings.csv

We import that to a Google Sheet where missing translations are highlighted in red:

https://docs.google.com/spreadsheets/d/1w2vv6Tt5uvjKLLHX4M6kv8yFDN-sSvwuMUz2MbeFNjY/edit#gid=0

And that can be exported to CSV again, run through our tool, and easily imported back into the app with a clean diff to track changes:

cat strings-from-google-sheet.csv | stringtool.py tostrings

See some red on that sheet under a language you speak? Let us know!t

Releasing

  1. Bump the versionCode and versionName in the app/build.gradle file.
  2. Annotate any un-translated strings with tools:ignore="MissingTranslation" (this change won't be committed)
  3. Run the "Generate signed APK…" action in Android Studio
  • You'll need the signing keystore and the passwords for both the store itself and the key
  1. Test the signed APK by running adb install app/build/outputs/apk/app-release.apk
  2. Copy in the prod configuration with cp app/google-services-prod.json app/google-services.json (this change won't be committed)
  3. Upload that APK to https://play.google.com/apps/publish (there's an "APK" tab on the left)
  4. Undo the changes that shouldn't be committed with something like git checkout -- app/google-services.json app/src/main/res/values/strings.xml
  5. Commit the version number increase with a message like "Version X.Y"

Why?

Maybe you've seen some recent news that says we're facing the largest refugee crisis since World War II. Maybe you've thought that you'd really like to help the victims of this crisis, but you've got no idea where to start.

When it comes to refugees, they're literally showing up on the doorstep of your community, so helping out is as easy as showing some hospitality! This app takes a small step in that direction. We're building something to ease the transition, and hopefully they'll find our home a bit better as a result.

Want to help?

Thanks!

You're still here! Have some legalese:

The original authors work for Google, so the code is all © Google Inc., but this is not an official Google project.

You can’t perform that action at this time.