# digits-friend-finder-playground

## Goals

Implement the minimum required to:

* use Digits Friend Finder on Android
* dump debug info, ie log everything
* commit project to a public repo, eg generalize keys and secrets


## Set up

1. Clone this repo
1. Import project into Android Studio
1. Install Fabric plugin for Android Studio
1. Use the plugin to install Digits
1. Note the TWITTER_KEY and TWITTER_SECRET injected into the app
1. Copy TWITTER_KEY and TWITTER_SECRET into the app/fabric.properties file generated by the plugin:
    TWITTER_KEY=...
    TWITTER_SECRET=...
1. Sync gradle to generate BuildConfig
1. Build and install app on a device with an address book
1. Tap "use my phone number" to log into app
1. Tap "upload" upload contacts
1. Tap "get" to get a list of your contacts who are using this app


## References

* [Fabric's Android Studio plugin instructions](https://fabric.io/downloads/android-studio)
* [Digits' _Sign In with Phone Number_ Android tutorial](https://fabric.io/kits/android/digits/features)
* [Digits' _Find Your Friends_ documentation](https://docs.fabric.io/android/digits/find-friends.html)
* [Digits' _Find Your Friends_ iOS tutorial](https://fabric.io/kits/ios/digits/features)

# Digits Friend Finder Playground

## Goals

Implement the minimum required to:

* use Digits Friend Finder on Android
* dump debug info, ie log everything
* commit project to a public repo, eg generalize keys and secrets


## Set up

1. Clone this repo
1. Cd into repo and run `git submodule init` and `git submodule update` to clone digits-android
1. Import project into Android Studio
1. Install Fabric plugin for Android Studio
1. Use the plugin to install Digits
1. Note the TWITTER_KEY and TWITTER_SECRET injected into the app
1. Copy TWITTER_KEY and TWITTER_SECRET into the digits-friend-finder-playground/app/fabric.properties file generated by the plugin:
    TWITTER_KEY=...
    TWITTER_SECRET=...
1. Sync gradle to generate BuildConfig
1. Build and install app on a device with an address book
1. Tap "use my phone number" to log into app
1. Tap "upload" upload contacts
1. Tap "get" to get a list of your contacts who are using this app
1. Filter logs by "dffp" tag


## References

* [Fabric's Android Studio plugin instructions](https://fabric.io/downloads/android-studio)
* [Digits' _Sign In with Phone Number_ Android tutorial](https://fabric.io/kits/android/digits/features)
* [Digits' _Find Your Friends_ documentation](https://docs.fabric.io/android/digits/find-friends.html)
* [Digits' _Find Your Friends_ iOS tutorial](https://fabric.io/kits/ios/digits/features)

Update docs re digits-android submodule
Update docs re digits-android submodule
