Initial Commit

Author: JimDaly

.gitignore

@@ -0,0 +1,31 @@
+#built application files
+*.apk
+*.ap_
+
+# files for the dex VM
+*.dex
+
+# Java class files
+*.class
+
+# generated files
+bin/
+gen/
+
+# Local configuration file (sdk path, etc)
+local.properties
+
+# Windows thumbnail db
+Thumbs.db
+
+# OSX files
+.DS_Store
+
+# Proguard folder generated by Eclipse
+proguard/
+
+# Android Studio
+*.iml
+.idea
+.gradle
+build/

License.txt

@@ -0,0 +1,21 @@
+
+Copyright (c) Microsoft Corporation
+
+All rights reserved. 
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+and associated documentation files (the ""Software""), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
+NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1 +1,39 @@
-# Android-Activity-Tracker-for-Dynamics-CRM-Web-API
+# Android Activity Tracker Sample App for Microsoft Dynamics CRM
+
+These instructions describe how to build and run the sample Android Activity Tracker application. 
+
+## Register the application
+
+Applications that access CRM business data, using the OAuth identity provider of the organization web service, must be registered in Active Directory. For an on-premises/IFD CRM deployment, AD FS 3.0 (or later) is used to register the app. With CRM Online, Microsoft Azure Active Directory is used for app registration. The result of application registration is a client ID value and a redirect URI that must be placed into the sample application's code where indicated in the next section. These values are used in the authentication process to determine whether the app has permission to access the organization's data.
+
+For information on how to register an application, see [Walkthrough: Register a CRM app with Active Directory](https://msdn.microsoft.com/en-us/library/dn531010.aspx).
+
+For internal app testing, you can share a single app registration across multiple apps. An app registration contains a single client ID, but can include multiple redirect URI's. For testing, you can add a redirect URI for each app you are developing. Once you are ready to publish an app to the Play Store, the app need's its own registration.
+
+## Build the application
+
+Prerequisites: This sample requires Android Studio 2, JDK 1.8.0, Android 6, and CRM 2016 to build and run.
+
+1. Load the app's project, located in the ActivityTracker folder under the project’s root folder, into Android Studio (note: if this is the first time you are opening the project, you need to import it so it properly sets up the workspace and gradle system).
+2. In the project view, expand app > src > main > java > com.microsoft.activitytracker > ui.
+3. Edit the SetupActivity.java file.
+4. On line 46 in the code file, change the provided value of `CLIENT_ID` to the client ID value from your app registration.
+5. On line 47 in the code file, change the provided value of `REDIRECT_URI` to the redirect URI value from your app registration.
+6. Build the application.
+
+## Run the application
+
+On the mobile device where you deployed the app, choose the Activity Tracker app to start it. The following screens show how to access the features of the app.
+
+Page | Visual Navigation | Description
+------- | ---- | ----
+Server and account | ![Server URL and username](./_images/1A - Server URL.png) | Enter the https:// root address of your CRM server, including the name of your domain, and the username of the logon system user account. If you do not know the URL, you can find it in the CRM web application by navigating to **Settings > Customization > Developer Resources**. An example URL would be: https://mydomain.crm.dynamics.com. Choose **Start Login** to continue.
+Logon credentials |![Logon credentials](./_images/2A - Logon.png) | Enter your the system user account password, for the organization that you specified on the previous page, and choose **Sign in**.
+Search | ![Search results](./_images/4A - Contact list.png) | The main page is initially blank with no contacts showing. Choose the search icon and enter one or more letters to find all contacts whose full name contain those letters.
+Contact details | ![Contact record](./_images/5A - Contact record with activity.png) | From the search results, choose a contact to display the details for that contact. On the details page, you can choose the street address to see that location on a map, the phone number to call the contact, or the email icon to send an email.
+Activity Creation | ![Contact new](./_images/5A1 - Contact create types.png) | Press the + floating action button to display the different types of activities you can create. Note that only the check mark command is enabled. The other commands are just place holders.
+New activity | ![New activity](./_images/6A - Adding an activity.png) | Choose the check mark icon on the details page to create a new activity for the contact. Enter the requested information. Choose the check mark again to save the activity record and return to the details page.
+
+## Notes
+
+Normally in oAuth you want to store the token and the refresh token so if the access token hasn't expired yet, you just reuse that one. Otherwise you pass the refresh token to get a new access token. Since you are unable to access the Token from ADAL, and you are required to pass the refresh token into `acquireTokenByRefreshToken` you have to actually store them manually as shown in this sample. If you want to continuously refresh without caring if the access token is still valid or not, all you have to store is the refresh token.

_images/1A - Server URL.png

@@ -0,0 +1,117 @@
+apply plugin: 'com.android.application'
+apply plugin: 'com.neenbedankt.android-apt'
+apply plugin: 'me.tatarka.retrolambda'
+
+android {
+
+    packagingOptions {
+        exclude 'META-INF/LICENSE.txt'
+        exclude 'META-INF/NOTICE.txt'
+        exclude '.readme'
+    }
+
+    lintOptions {
+        abortOnError false
+    }
+
+    compileSdkVersion 23
+    buildToolsVersion '23.0.3'
+    defaultConfig {
+        minSdkVersion 19
+        targetSdkVersion 23
+        versionCode 1
+        versionName "0.0.1"
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    dataBinding {
+        enabled = true
+    }
+
+}
+
+buildscript {
+    repositories {
+        mavenCentral()
+        jcenter()
+    }
+
+    dependencies {
+//        Retrolambda is brought in so I can utilize Java 8 Lambda functionality, since
+//        Official support with the jack compiler isn't available with use of Annotation
+//        Processors
+        classpath 'me.tatarka:gradle-retrolambda:3.2.5'
+        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
+    }
+}
+
+repositories {
+    mavenCentral()
+
+    flatDir {
+        dirs 'libs'
+    }
+
+    maven { url 'https://jitpack.io' }
+}
+
+def dbflow_version = "3.0.1"
+
+dependencies {
+    compile fileTree(include: ['*.jar'], dir: 'libs')
+    compile project(path: ':xrm')
+
+//    Debug tools for finding memory leaks, checking network calls, debug views, and
+//    check the database with sql queries and table checks
+    debugCompile 'com.squareup.leakcanary:leakcanary-android:1.4-beta2'
+    releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.4-beta2'
+    debugCompile 'com.facebook.stetho:stetho:1.3.1'
+    debugCompile 'com.facebook.stetho:stetho-okhttp:1.3.1'
+    debugCompile 'com.facebook.stetho:stetho-urlconnection:1.3.1'
+
+//    Google libraries
+    compile 'com.android.support:support-v4:23.4.0'
+    compile 'com.android.support:appcompat-v7:23.4.0'
+    compile 'com.android.support:recyclerview-v7:23.4.0'
+    compile 'com.android.support:design:23.4.0'
+
+//    Google's Dagger Dependency Injection Annotation Processor
+    apt 'com.google.dagger:dagger-compiler:2.2'
+    compile 'com.google.dagger:dagger:2.2'
+
+//    Google's Databinding Annotation Processor
+    apt 'com.android.databinding:compiler:2.0.0-rc3'
+
+//    Database ORM Annotation Processor
+    apt "com.github.Raizlabs.DBFlow:dbflow-processor:${dbflow_version}"
+    compile "com.github.Raizlabs.DBFlow:dbflow-core:${dbflow_version}"
+    compile "com.github.Raizlabs.DBFlow:dbflow:${dbflow_version}"
+
+//    RXJava is the famous reactive library used in all kinds of libraries, this is very powerful
+//    and allows you to no longer have to use huge messy AsyncTasks. RXAndroid allows you to go right
+//    back to the UI Thread with a AndroidScheduler.
+    provided 'org.glassfish:javax.annotation:10.0-b28'
+    compile 'io.reactivex:rxandroid:1.1.0'
+    compile 'io.reactivex:rxjava:1.1.2'
+
+//    Square's Networking framework build on top of their okhttp library, along with the
+//    jackson converter and adapter for rxjava so responses can be observable
+    compile 'com.squareup.retrofit2:retrofit:2.0.1'
+    compile 'com.squareup.retrofit2:converter-jackson:2.0.1'
+    compile 'com.squareup.retrofit2:adapter-rxjava:2.0.1'
+
+//    Common library to reduce boilerplate code when working with views. Allowing you to
+//    "bind" events with methods and auto bind views to variables.
+    compile 'com.jakewharton:butterknife:7.0.1'
+
+
+    compile 'org.mod4j.org.apache.commons:lang:2.1.0'
+    compile('com.microsoft.aad:adal:1.2.0') {
+        exclude group: 'com.android.support'
+    }
+
+}

_images/2A - Logon.png

@@ -0,0 +1,3 @@
+#Contains API Secret used to validate your application. Commit to internal source control; avoid making secret public.
+#Sun Sep 06 23:37:02 CDT 2015
+

_images/5A - Contact record with activity.png

@@ -0,0 +1,55 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /Users/JeremyShore/Library/Android/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Retrofit
+-dontwarn retrofit.**
+-keep class retrofit.** { *; }
+-keepattributes Signature
+-keepattributes Exceptions
+
+# Xrm
+-keep class com.microsoft.xrm.sdk.** { *; }
+-keep class * extends com.microsoft.xrm.sdk.Entity { *; }
+
+# Google
+-dontwarn android.support.v7.**
+-keep class android.support.v7.** { *; }
+-keep interface android.support.v7.** { *; }
+
+-keep public class com.google.android.gms.* { public *; }
+-dontwarn com.google.android.gms.**
+
+# Debugging
+-dontwarn com.facebook.stetho.**
+-keep class com.facebook.stetho.** { *; }
+
+-dontwarn okio.**
+-keep class okio.** { *; }
+
+#Butterknife
+-keep class butterknife.** { *; }
+-dontwarn butterknife.internal.**
+-keep class **$$ViewBinder { *; }
+
+-keepclasseswithmembernames class * {
+    @butterknife.* <fields>;
+}
+
+-keepclasseswithmembernames class * {
+    @butterknife.* <methods>;
+}

_images/5A1 - Contact create types.png

@@ -0,0 +1,10 @@
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="com.microsoft.activitytracker">
+
+    <application
+        tools:replace="android:name"
+        android:name=".DebugActivityTracker" />
+
+</manifest>

_images/6A - Adding an activity.png

@@ -0,0 +1,19 @@
+package com.microsoft.activitytracker;
+
+import com.facebook.stetho.Stetho;
+import com.microsoft.activitytracker.classes.ActivityTracker;
+
+public final class DebugActivityTracker extends ActivityTracker {
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+
+        Stetho.initialize(
+            Stetho.newInitializerBuilder(this)
+                .enableDumpapp(Stetho.defaultDumperPluginsProvider(this))
+                .enableWebKitInspector(Stetho.defaultInspectorModulesProvider(this))
+                .build());
+
+    }
+}

app/build.gradle

@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="com.microsoft.activitytracker">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+
+    <application
+        android:name=".classes.ActivityTracker"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/ActivityTracker"
+        tools:replace="theme">
+
+        <activity
+            android:name="com.microsoft.aad.adal.AuthenticationActivity"
+            android:theme="@style/ActivityTracker.Activities"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:exported="true">
+
+        </activity>
+        <activity
+            android:name=".ui.MainActivity"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:theme="@style/ActivityTracker.Activities">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.default_searchable"
+                android:value=".ui.SearchActivity" />
+        </activity>
+        <activity
+            android:name=".ui.CreateActivity"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:theme="@style/ActivityTracker.Activities"
+            android:windowSoftInputMode="adjustPan">
+
+        </activity>
+        <activity
+            android:name=".ui.ItemActivity"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:theme="@style/ActivityTracker.Activities"
+            android:parentActivityName=".ui.MainActivity">
+
+        </activity>
+        <activity
+            android:name=".ui.SetupActivity"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:theme="@style/ActivityTracker.Activities"
+            android:launchMode="singleTop">
+
+        </activity>
+
+        <activity
+            android:name=".ui.SearchActivity"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:theme="@style/ActivityTracker.Activities"
+            android:launchMode="singleTop">
+
+            <intent-filter>
+                <action android:name="android.intent.action.SEARCH" />
+            </intent-filter>
+
+            <intent-filter>
+                <action android:name="com.google.android.gms.actions.SEARCH_ACTION" />
+                <category android:name="android.intent.category.DEFAULT" />
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.searchable"
+                android:resource="@xml/searchable" />
+        </activity>
+
+    </application>
+
+</manifest>