From cfca745a6f176a3bf138348e05f2f7c3f3979933 Mon Sep 17 00:00:00 2001
From: atanasovg <georgi.atanassoff@yahoo.com>
Date: Wed, 7 May 2014 19:25:08 +0300
Subject: [PATCH] Updated the Android UnitTestApp to the latest Bridges. Added
 Application comments.

---
 Application/application.d.ts | 126 +++++++++++++++++++++++++++++++----
 1 file changed, 114 insertions(+), 12 deletions(-)

diff --git a/Application/application.d.ts b/Application/application.d.ts
index 3bf09baf1..a0c851200 100644
--- a/Application/application.d.ts
+++ b/Application/application.d.ts
@@ -1,41 +1,143 @@
-export declare enum TargetOS {
+/**
+* Defines the available target operating systems.
+*/
+export declare enum TargetOS {
     iOS,
     Android
 }
 
+/**
+* The current singleton instance of the application object.
+*/
 export declare var current: Application;
 
+/**
+* The abstraction of an Application object, common for each target OS.
+*/
 export declare class Application {
+    /**
+    * The target operating system of the application.
+    */
     public os: TargetOS;
 
+    /**
+    * The main entry point event. This method is expected to return an instance of the root UI for the application.
+    * This will be an Activity extends for Android and a RootViewController for iOS.
+    */
     public onLaunch: () => any;
+
+    /**
+    * This method will be called when the Application is suspended.
+    */
     public onSuspend: () => any;
+
+    /**
+    * This method will be called when the Application is resumed after it has been suspended.
+    */
     public onResume: () => any;
+
+    /**
+    * This method will be called when the Application is about to exit.
+    */
     public onExit: () => any;
+
+    /**
+    * This method will be called when there is low memory on the target device.
+    */
     public onLowMemory: () => any;
 
+    /**
+    * This is the Android-specific application object instance. It encapsulates methods and properties specific to the Android platform.
+    */
     public android: AndroidApplication;
+
+    /**
+    * This is the iOS-specific application object instance. It encapsulates methods and properties specific to the iOS platform.
+    */
     public ios: iOSApplication;
 }
 
-export declare function init(nativeApp: any);
-
+/**
+* The abstraction of an Android-specific application object.
+*/
 export declare class AndroidApplication {
+    /**
+    * The android.app.Application object instance provided to the init of the module.
+    */
     public nativeApp: android.app.Application;
+
+    /**
+    * The android.content.Context object instance.
+    */
     public context: android.content.Context;
+
+    /**
+    * The currently active (loaded) android.app.Activity. This property is automatically updated upon Activity events.
+    */
     public currentActivity: android.app.Activity;
-    public startActivity: android.app.Activity;
+
+    /**
+    * The main (start) Activity for the application.
+    */
+    public mainActivity: android.app.Activity;
+
+    /**
+    * The name of the application package.
+    */
     public packageName: string;
 
-    public onActivityCreated: (activity: android.app.Activity, bundle: android.os.Bundle) => any;
-    public onActivityDestroyed: (activity: android.app.Activity) => any;
-    public onActivityStarted: (activity: android.app.Activity) => any;
-    public onActivityPaused: (activity: android.app.Activity) => any;
-    public onActivityResumed: (activity: android.app.Activity) => any;
-    public onActivityStopped: (activity: android.app.Activity) => any;
-    public onSaveActivityState: (activity: android.app.Activity, bundle: android.os.Bundle) => any;
+    /**
+    * This method is called by the JavaScript Bridge when navigation to a new activity is triggered.
+    * The return value of this method should be com.tns.NativeScriptActivity.extends implementation.
+    */
+    // TODO: Why is the android.content.Intent module rather than a class?
+    public getActivity: (intent: android.content.Intent) => any;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onActivityCreated method.
+    */
+    public onActivityCreated: (activity: android.app.Activity, bundle: android.os.Bundle) => void;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onActivityDestroyed method.
+    */
+    public onActivityDestroyed: (activity: android.app.Activity) => void;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onActivityDestroyed method.
+    */
+    public onActivityStarted: (activity: android.app.Activity) => void;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onActivityPaused method.
+    */
+    public onActivityPaused: (activity: android.app.Activity) => void;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onActivityResumed method.
+    */
+    public onActivityResumed: (activity: android.app.Activity) => void;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onActivityStopped method.
+    */
+    public onActivityStopped: (activity: android.app.Activity) => void;
+
+    /**
+    * Direct handler of the android.app.Application.ActivityLifecycleCallbacks.onSaveActivityState method.
+    */
+    public onSaveActivityState: (activity: android.app.Activity, bundle: android.os.Bundle) => void;
 }
 
+/**
+* The abstraction of an iOS-specific application object.
+*/
 export declare class iOSApplication {
+    // TODO: what methods/properties we can put here
     public rootController: any;
-}
\ No newline at end of file
+}
+
+/**
+* Entry point for the module. Initializes the Application singleton and hooks application lifecycle events.
+*/
+export declare function init(nativeApp: any);
\ No newline at end of file