Open Lecture Mobile Programming. Firebase Tools

Transcription

1 Open Lecture Mobile Programming Firebase Tools

2 Agenda Setup Firebase Authentication Firebase Database Firebase Cloud Messaging

3 Setting up a new Firebase project Navigate to Create new project and fill out form Download google-services.json and add to <ProjectDir>/app Contains API key, firebase url, etc.

4 Setting up a new Firebase project Add to <ProjectDir>/build.gradle: buildscript { //... dependencies { //... classpath 'com.google.gms:google-services:3.2.0' Add to <ProjectDir>/app/build.gradle: dependencies { //... apply plugin: 'com.google.gms.google-services'

5 Firebase Authentication Integrate authentication using Google, Facebook, Twitter, and GitHub accounts Provides built-in UI Add to app/build.gradle: compile 'com.google.firebase:firebase-auth:11.8.0'

6 Firebase Authentication w/ Google Login with Google account Add to app/build.gradle: compile 'com.google.android.gms:play-services-auth:11.8.0' Add Google sign-in button Add to layout: <com.google.android.gms.common.signinbutton android:layout_width="wrap_content" android:layout_height="wrap_content" />

7 Firebase Authentication w/ protected void oncreate(bundle savedinstancestate) { mauth = FirebaseAuth.getInstance(); GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN).requestIdToken(getString(R.string.default_web_client_id)).request ().build(); mgoogleapiclient = new GoogleApiClient.Builder(this).enableAutoManage(MainActivity.this, this /* OnConnectionFailedListener */).addapi(auth.google_sign_in_api, gso).build();

8 Firebase Realtime Database Remote database Easy API JSON-formatted GET, PUSH, PUT Automatically serialize custom class Get database reference: FirebaseDatabase database = FirebaseDatabase.getInstance().getReference(); Perform operations on Database reference as if it were a Bundle compile 'com.google.firebase:firebase-database:11.8.0'

9 Firebase Realtime Database (PUSH) Creates unique string (Primary Key) Index into database using uniquekey Create new entry at index uniquekey with given values public static boolean savetodatabase(firebaseuser acct) { FirebaseDatabase database = FirebaseDatabase.getInstance(); DatabaseReference myref = database.getreference(); MyUser user = new MyUser(acct.getDisplayName(), acct.get (), new Date()); String key = myref.child( users ).push().getkey(); Map<String, Object> postvalues = user.tomap(); Map<String, Object> childupdates = new HashMap<>(); childupdates.put("/users/" + key, postvalues); myref.updatechildren(childupdates); return true;

10 Firebase Realtime Database (GET) public void loadfromdatabase() { FirebaseDatabase database = FirebaseDatabase.getInstance(); DatabaseReference myref = database.getreference(firebase_table); myref.addvalueeventlistener(new ValueEventListener() public void ondatachange(datasnapshot datasnapshot) { for(datasnapshot usersnapshot : datasnapshot.getchildren()) { String key = usersnapshot.getkey(); MyUser user = MyUser.fromDataSnapshot(userSnapshot); public void oncancelled(databaseerror error) { // Failed to read value Log.w(TAG, "Failed to read value.", error.toexception()); );

11 Firebase Realtime Database (PUT) Updates existing entry Need to fetch uniquekey Set values at index uniquekey private void updatemessageinfirebasedb(string msgkey, MyMessage msg) { FirebaseDatabase database = FirebaseDatabase.getInstance(); // Convert msg to Map Map<String, Object> msgvalues = post.tomap(); Map<String, Object> childupdates = new HashMap<>(); // Update entry values to for /messages/<key> childupdates.put("/messages/" + key, msgvalues);

12 Firebase Realtime Database (PUT) Updates existing entry Need to fetch uniquekey Set values at index uniquekey private void updatemessageinfirebasedb(string msgkey, MyMessage msg) { FirebaseDatabase database = FirebaseDatabase.getInstance(); // Convert msg to Map Map<String, Object> msgvalues = post.tomap(); Map<String, Object> childupdates = new HashMap<>(); // Update entry values to for /messages/<key> childupdates.put("/messages/" + key, msgvalues);

13 Firebase Firestore (Beta) Improves on the efficiency of the Realtime DB Currently in Beta mode Uses a new Documents data model Easier to insert/get nested data Allows for faster and more complex queries For more details:

14 Firebase Cloud Messaging Easy API JSON-formatted messages Plain notification messages and Data messages Requires only two Services: One to update the Client token (register device) One to handle new messages Add to build.gradle: compile com.google.firebase:firebase-messaging:11.8.0

15 Firebase Cloud Messaging Add to AndroidManifest: <service android:name=".tokenupdateservice"> <intent-filter> <action android:name="com.google.firebase.instance_id_event" /> </intent-filter> </service> <service android:name=".notificationlistenerservice"> <intent-filter> <action android:name="com.google.firebase.messaging_event" /> </intent-filter> </service>

16 Firebase Cloud Messaging TokenUpdateService: Receives new token when app first launches or token updates When new token received, adds to Firebase Database This way we have a list of clients when sending messages public class TokenUpdateService extends FirebaseInstanceIdService public void ontokenrefresh() { String refreshedtoken = FirebaseInstanceId.getInstance().getToken(); Log.d(TAG, "Refreshed token: " + refreshedtoken); sendregistrationtoserver(refreshedtoken); private void sendregistrationtoserver(string token) { FirebaseDatabase database = FirebaseDatabase.getInstance(); DatabaseReference myref = database.getreference("clients"); myref.child(msgid.incrementandget()).setvalue(token);

17 Firebase Cloud Messaging NotificationListenerService: Receives and unpacks RemoteMessage If more processing required, send msg to Firebase JobDispatcher public class NotificationListenerService extends FirebaseMessagingService public void onmessagereceived(remotemessage remotemessage) { Log.d(TAG, "From: " + remotemessage.getfrom()); // Check if message contains a data payload. if (remotemessage.getdata().size() > 0) { // Iterate over message data for (Map.Entry<String, String> entry : map.entryset()) { Log.d(TAG, entry.getkey() + ": " + entry.getvalue());

18 Firebase Cloud Messaging - Sending Send message to Firebase Project url Can send to specific devices Fetch current Device IDs from database (previous slides) Can send to group of devices using Topic Content-Type:application/json Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA { "condition": "'dogs' in topics 'cats' in topics", "data": { "message": "This is a Firebase Cloud Messaging Topic Message!",

19 Firebase Cloud Messaging - Sending Set up server to send notifications Several Python libraries: ex. pyfcm Simple wrapper for building url and sending ex. def sendfcmdatamessage(apikey, cli_ids, title, body, url): from pyfcm import FCMNotification push_service = FCMNotification(api_key = apikey) data = { 'title' : title, 'body': body, 'url': url, res = push_service.notify_multiple_devices(registration_ids=cli_ids, data_message = data) print 'Response: ', res

20 References Firebase Developer Site Mobile