familysearch / mobile-android-sample

Sample mobile native android app

mobile-android-sample

This is a sample native android app that you can use as a starting point in creating your own mobile app that integrates with FamilySearch APIs.

For other sample apps and SDK information see https://familysearch.org/developers/libraries

Tools required

In order to use this demo application you must first have installed:

• Android Studio
• Android SDK version 23 (Can be installed from within Android Studio, or with homebrew brew install android-sdk)
• JDK7
• An API key issued by Family Search. Place ths key inside of AppKeys.java

Create AppKeys.java file

Create a file called AppKeys.java in the folder app/src/main/java/org/familysearch/sampleapp. Add a static String variable named API_KEY, with the value being your FamilySearch app key.

Example:

package org.familysearch.sampleapp;

public class AppKeys {
    public static final String API_KEY = "your_api_key";
}

Screen Shots

mobile-android-sample's Issues

Issues logging in with the sandbox

I want to be able to see the TreeActivity, but getting a token always fails. I got an API Key and a sandbox username and password. They all seem to work when I tested OAuth with fiddle, but I can't get it working inside the app.

Can't login to the app

These are my steps:

• Create an account at familysearch.org/developers.
  Create a new App to obtain an App Key (an 18 digits alpha-numeric string).
  Put http://fiddle.jshell.net as Redirect URI.
  At step 2 App In Development click "Done".
  At step 3 Review Compatibility don't click "Apply for Compatible Review".

• In the Test OAuth2 JS Fiddle put the App Key.
  Run the code.
  Login with username and password of Integration (Sandbox) account.
  Successfully receive an Access token.

• From GitHub download FamilySearch/mobile-android-sample.
  Unzip and open in Android Studio 3.1.
  Android Studio automatically downloads all the Gradle, Android SDK Platform 23 and Build Tools.
  JDK 8 is already installed.
  Create the AppKeys.java class and put the App Key in.
  Successfully run FamilySearch Android Sample App in a smartphone.

• In the smartphone try to login to the app with the Sandbox account, and also with my FamilySearch account, and the developer account...

The result is always that is impossible to login to the app, with a message:

Error getting the token. Check username and password

Meanwhile Android Studio Logcat writes:

I/PhoneWindow: [generateLayout] setColorNavigationBar => color=0x ff000001
D/PhoneWindowEx: Ex5. SystemProperties.get(KEY) result is NULL!!
D/libc-netbsd: [getaddrinfo]: hostname=xxxxx; servname=(null); cache_mode=(null), netid=0; mark=0
[getaddrinfo]: ai_addrlen=0; ai_canonname=xxxxx; ai_flags=4; ai_family=0
[getaddrinfo]: hostname=xxxxx; servname=(null); cache_mode=(null), netid=0; mark=0
[getaddrinfo]: ai_addrlen=0; ai_canonname=xxxxx; ai_flags=1024; ai_family=0
I/System.out: propertyValue:false
E/CliptrayUtils: hideClipTrayIfNeeded() TextView is focused!! hideClipTray()

Am I doing something wrong?

Login text

The login screen needs to show the following text.

"By clicking the "LOGIN" button, I agree to [Product Name] knowing my basic FamilySearch profile information and accessing data about my ancestors from the FamilySearch family tree. [Product Name] will use this information in accordance with their respective terms of service and privacy policies."