added installationId and updated readme

Author: PeterStaev

README.md

@@ -66,9 +66,19 @@ Registers the given native push token for push notifications with Azure.
 * **registerWithTemplate(string, string, string): Promise**  
 Registers the given native push token, template name and template for push notifications with Azure. For more information about templates see the usage [below](#register-with-a-template). 
 
+* **registerWithTags(string, string[]): Promise**  
+Registers the given native push token for push notifications with Azure and associates the given tags with the device installation. You can read more about tags [here](https://docs.microsoft.com/en-us/azure/notification-hubs/notification-hubs-tags-segment-push-message).
+
+* **registerWithTagsAndTemplate(string, string[], string, string): Promise**  
+This combines the above 2 methods, so you can register both with a template and tags. 
+
 * **unregister(): Promise**  
 Unregisters the device from Azure push notifications. 
 
+#### Properties 
+* **installationId** - *string*
+Returns the `installationId` of the device what is registered with Azure's Notification Hubs. This is usefull, for example, in case you need custom tags and you need to call your backend to add the tags.
+
 ### `MobileServiceUser`
 
 #### Static Methods

demo/app/main-page.ts

@@ -167,7 +167,7 @@ export function onPushRegisterTap() {
             pushPlugin.onMessageReceived(pushSettings.notificationCallbackAndroid);
         }
         client.push.register(data)
-            .then(() => console.log("Azure Register OK!"))
+            .then(() => console.log("Azure Register OK!", client.push.installationId))
             .catch((e) => console.log(e));
     }, (e) => { console.log(e); });
 }

demo/package.json

@@ -4,10 +4,10 @@
   "readme": "Azure Mobile Apps Service application",
   "nativescript": {
     "id": "inc.tangra.azuremobileservicessample",
-    "tns-android": {
+    "tns-ios": {
       "version": "3.2.0"
     },
-    "tns-ios": {
+    "tns-android": {
       "version": "3.2.0"
     }
   },

push/push-common.ts

@@ -17,6 +17,8 @@ import * as definition from "nativescript-azure-mobile-apps/push";
 
 export abstract class MobileServicePush implements definition.MobileServicePush {
     protected _msPush;
+    
+    abstract get installationId(): string;
 
     constructor(nativeValue: any) {
         this._msPush = nativeValue;

push/push.android.ts

@@ -25,6 +25,10 @@ const PUSH_PLATFORM = "gcm";
 export class MobileServicePush extends common.MobileServicePush {   
     protected _msPush: com.microsoft.windowsazure.mobileservices.notifications.MobileServicePush;
 
+    get installationId(): string {
+        return com.microsoft.windowsazure.mobileservices.MobileServiceApplication.getInstallationId(application.android.currentContext);
+    }
+    
     public register(registrationId: string): Promise<any> {
         return new Promise((resolve, reject) => {
             try {
@@ -58,7 +62,6 @@ export class MobileServicePush extends common.MobileServicePush {
     public registerWithTagsAndTemplate(registrationId: string, tags: string[], templateName: string, templateBody: string): Promise<any> {
         return new Promise((resolve, reject) => {
             try {
-                const installationId = com.microsoft.windowsazure.mobileservices.MobileServiceApplication.getInstallationId(application.android.currentContext);
                 let tagsAsList: java.util.List<string> = null;
                 let templates: java.util.HashMap<string, com.microsoft.windowsazure.mobileservices.notifications.InstallationTemplate> = null;
 
@@ -72,7 +75,7 @@ export class MobileServicePush extends common.MobileServicePush {
                 }
 
                 const installation = new com.microsoft.windowsazure.mobileservices.notifications.Installation(
-                    installationId,
+                    this.installationId,
                     PUSH_PLATFORM,
                     registrationId,
                     null,

push/push.d.ts

@@ -19,6 +19,8 @@ declare module "nativescript-azure-mobile-apps/push" {
 
         constructor(nativeValue: any);
 
+        public readonly installationId: string;
+
         public register(registrationId: string): Promise<any>;
         public registerWithTemplate(registrationId: string, templateName: string, templateBody: string): Promise<any>;
         public registerWithTags(registrationId: string, tags: string[]): Promise<any>;

push/push.ios.ts

@@ -23,6 +23,10 @@ const PUSH_PLATFORM = "apns";
 export class MobileServicePush extends common.MobileServicePush {
     protected _msPush: MSPush;
 
+    get installationId(): string {
+        return this._msPush.installationId;
+    }
+
     public register(registrationId: string): Promise<any> {
         return new Promise((resolve, reject) => {
             try {