update windows batch script for generating android defs

update README

Author: petekanev

.gitignore

@@ -11,6 +11,7 @@
 /captures
 
 /out
+/output
 /newApp
 /dts_gen_app
 testparams.txt

.vscode/.BROWSE.VC.DB

@@ -1,2 +1,43 @@
 # android-dts-generator
 A tool that generates TypeScript declaration files (.d.ts) from Jars
+
+> Because there are certain incompatibilities between Java and TypeScript, definitions MAY NOT always be completely accurate. They will however compile and provide auto complete feature inside a modern text editor supporting typings.
+
+### Quirks
+ - Interfaces are represented by classes, this will allow you to extend them by using the `new` syntax, as well as show you all its members that need to be implemented
+ - Classes from the package `java.util.function` don't have their typings generated, as `function` is a reserved keyword in TypeScript and JavaScript
+ - Classes returning values of Type in the package `java.util.function` will return `any` instead
+ - Classes using methods with parameters of Type in the package `java.util.function` will take `any` instead
+ - Classes implementing `java.util.Iterator`, `android.animation.TypeEvaluator`, `java.lang.Comparable` do not implement those interfaces in the generated definitions for compatibility-related issues
+
+
+### Generate definitons for Android SDK
+```shell
+cd dts-generator
+gradlew jar
+java -jar build\libs\dts-generator.jar -input %ANDROID_HOME%\platforms\android-<Platform Level (21/22/23/24)>\android.jar
+```
+
+### Generate definitions for any Jar
+```shell
+cd dts-generator
+gradlew jar
+java -jar build\libs\dts-generator.jar -input <Path to your Jar>
+```
+
+### Pass multiple jars to generator
+```shell
+cd dts-generator
+gradlew jar
+java -jar build\libs\dts-generator.jar -input <jar1> <jar2> <jar3>
+```
+
+### Generate definitions for .aar
+```
+Open the .aar archive
+Extract the classes.jar and any dependencies it may have inside libs/
+Rename classes.jar if necessary
+```
+```shell
+java - jar build\libs\dts-generator.jar -input classes.jar dependency-of-classes-jar.jar
+```

.vscode/.BROWSE.VC.DB-wal

@@ -0,0 +1,3 @@
+cd dts-generator
+
+gradlew jar

README.md

@@ -0,0 +1,21 @@
+start cmd.exe /C gen-gradle.win.bat
+
+rmdir /s /q output
+
+mkdir output\android-21
+mkdir output\android-22
+mkdir output\android-23
+mkdir output\android-24
+
+java -jar dts-generator\build\libs\dts-generator.jar -input %ANDROID_HOME%\platforms\android-21\android.jar dts-generator\jars\21.0.3\internal-v4.jar dts-generator\jars\21.0.3\v4.jar dts-generator\jars\21.0.3\v7.jar -output output\android-21
+
+java -jar dts-generator\build\libs\dts-generator.jar -input %ANDROID_HOME%\platforms\android-22\android.jar dts-generator\jars\22.2.0\internal-v4.jar dts-generator\jars\22.2.0\v4.jar dts-generator\jars\22.2.0\v7.jar -output output\android-22
+
+java -jar dts-generator\build\libs\dts-generator.jar -input %ANDROID_HOME%\platforms\android-23\android.jar dts-generator\jars\23.3.0\internal-v4.jar dts-generator\jars\23.3.0\v4.jar dts-generator\jars\23.3.0\v7.jar -output output\android-23
+
+java -jar dts-generator\build\libs\dts-generator.jar -input %ANDROID_HOME%\platforms\android-24\android.jar dts-generator\jars\24.1.0\internal-v4.jar dts-generator\jars\24.1.0\v4.jar dts-generator\jars\24.1.0\v7.jar -output output\android-24
+
+xcopy /f /y _helpers.d.ts output\android-21
+xcopy /f /y _helpers.d.ts output\android-22
+xcopy /f /y _helpers.d.ts output\android-23
+xcopy /f /y _helpers.d.ts output\android-24