Merge branch 'master' into TIMOB-27934

tidev · Nov 4, 2020 · 9d8bc93 · 9d8bc93
2 parents 43b2234 + 6f02ca8
commit 9d8bc93
Show file tree

Hide file tree

Showing 24 changed files with 2,387 additions and 85 deletions.
diff --git a/MIGRATION_GUIDE.md b/MIGRATION_GUIDE.md
diff --git a/android/titanium/src/java/org/appcelerator/titanium/proxy/RProxy.java b/android/titanium/src/java/org/appcelerator/titanium/proxy/RProxy.java
@@ -1,6 +1,6 @@
 /**
  * Appcelerator Titanium Mobile
- * Copyright (c) 2011-2013 by Appcelerator, Inc. All Rights Reserved.
+ * Copyright (c) 2011-Present by Axway, Inc. All Rights Reserved.
  * Licensed under the terms of the Apache Public License
  * Please see the LICENSE included with this distribution for details.
  */
@@ -22,11 +22,11 @@ public class RProxy extends KrollProxy
 	private static final String TAG = "TiAndroidRProxy";
 
 	private static final String[] RESOURCE_TYPES = {
-		"anim",      "animator", "array",        "attr",   "bool",
-		"color",     "dimen",    "drawable",     "font",   "fraction",
-		"id",        "integer",  "interpolator", "layout", "menu",
-		"mipmap",    "plurals",  "raw",          "string", "style",
-		"styleable", "xml"
+		"anim",      "animator",   "array",        "attr",   "bool",
+		"color",     "dimen",      "drawable",     "font",   "fraction",
+		"id",        "integer",    "interpolator", "layout", "menu",
+		"mipmap",    "plurals",    "raw",          "string", "style",
+		"styleable", "transition", "xml"
 	};
 
 	public static final int RESOURCE_TYPE_ANDROID = 0;

diff --git a/apidoc/Titanium/Android/Activity.yml b/apidoc/Titanium/Android/Activity.yml
@@ -250,7 +250,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onCreate](Titanium.Android.Activity.onCreate) instead.
+        notes: Use the [Titanium.Android.Activity.onCreate](Titanium.Android.Activity.onCreate) callback property instead.
     description: |
         See also:
         [onCreate](https://developer.android.com/reference/android/app/Activity.html#onCreate(android.os.Bundle))
@@ -261,7 +261,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onDestroy](Titanium.Android.Activity.onDestroy) instead.
+        notes: Use the [Titanium.Android.Activity.onDestroy](Titanium.Android.Activity.onDestroy) callback property instead.
     description: |
         See also: [onDestroy](https://developer.android.com/reference/android/app/Activity.html#onDestroy())
         in the Android Developer Reference.
@@ -296,7 +296,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onPause](Titanium.Android.Activity.onPause) instead.
+        notes: Use the [Titanium.Android.Activity.onPause](Titanium.Android.Activity.onPause) callback property instead.
     description: |
         See also:
         [onPause](https://developer.android.com/reference/android/app/Activity.html#onPause())
@@ -307,7 +307,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onRestart](Titanium.Android.Activity.onRestart) instead.
+        notes: Use the [Titanium.Android.Activity.onRestart](Titanium.Android.Activity.onRestart) callback property instead.
     description: |
         See also: [onRestart](https://developer.android.com/reference/android/app/Activity.html#onRestart())
         in the Android Developer Reference.
@@ -317,7 +317,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onResume](Titanium.Android.Activity.onResume) instead.
+        notes: Use the [Titanium.Android.Activity.onResume](Titanium.Android.Activity.onResume) callback property instead.
     description: |
         See also: [onResume](https://developer.android.com/reference/android/app/Activity.html#onResume())
         in the Android Developer Reference.
@@ -327,7 +327,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onStart](Titanium.Android.Activity.onStart) instead.
+        notes: Use the [Titanium.Android.Activity.onStart](Titanium.Android.Activity.onStart) callback property instead.
     description: |
         See also: [onStart](https://developer.android.com/reference/android/app/Activity.html#onStart())
         in the Android Developer Reference.
@@ -337,7 +337,7 @@ events:
     deprecated:
         since: "3.4.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Android.Activity.onStop](Titanium.Android.Activity.onStop) instead.
+        notes: Use the [Titanium.Android.Activity.onStop](Titanium.Android.Activity.onStop) callback property instead.
     description: |
         See also: [onStop](https://developer.android.com/reference/android/app/Activity.html#onStop())
         in the Android Developer Reference.
@@ -371,7 +371,6 @@ events:
     since: "7.5.0"
 
 properties:
-
   - name: actionBar
     summary: The action bar for this activity.
     description: |

diff --git a/apidoc/Titanium/App/App.yml b/apidoc/Titanium/App/App.yml
@@ -294,6 +294,7 @@ events:
         deprecated: 
           since: "8.0.0"
           removed: "8.0.0"
+          notes: Use the `stack` property instead.
         platforms: [iphone, ipad]
       - name: title
         summary: The title for the error.

diff --git a/apidoc/Titanium/Calendar/Calendar.yml b/apidoc/Titanium/Calendar/Calendar.yml
@@ -713,7 +713,7 @@ properties:
     deprecated:
         since: "5.2.0"
         removed: "8.1.0"
-        notes: Use [Titanium.Calendar.calendarAuthorization](Titanium.Calendar.calendarAuthorization) instead.
+        notes: Use the [Titanium.Calendar.calendarAuthorization](Titanium.Calendar.calendarAuthorization) property instead.
     type: Number
     constants: Titanium.Calendar.AUTHORIZATION_*
     permission: read-only

diff --git a/apidoc/Titanium/Contacts/Contacts.yml b/apidoc/Titanium/Contacts/Contacts.yml
@@ -95,7 +95,7 @@ methods:
     deprecated:
         since: "5.0.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Contacts.getGroupByIdentifier](Titanium.Contacts.getGroupByIdentifier) instead.
+        notes: Use the [Titanium.Contacts.getGroupByIdentifier](Titanium.Contacts.getGroupByIdentifier) method instead.
 
   - name: getGroupByIdentifier
     summary: Gets the group with the specified identifier. 
@@ -131,7 +131,7 @@ methods:
     deprecated:
         since: "5.0.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Contacts.getPersonByIdentifier](Titanium.Contacts.getPersonByIdentifier) instead.
+        notes: Use the [Titanium.Contacts.getPersonByIdentifier](Titanium.Contacts.getPersonByIdentifier) method instead.
 
   - name: getPersonByIdentifier
     summary: Gets the person with the specified identifier.
@@ -229,7 +229,7 @@ methods:
     deprecated:
         since: "5.1.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Contacts.requestContactsPermissions](Titanium.Contacts.requestContactsPermissions) instead.
+        notes: Use the [Titanium.Contacts.requestContactsPermissions](Titanium.Contacts.requestContactsPermissions) method instead.
     summary: If authorization is unknown, will bring up a dialog requesting permission.
     description: |
         Note that the callback may be synchronous or asynchronous. That is, it may be called
@@ -333,7 +333,7 @@ properties:
     deprecated:
         since: "8.0.0"
         removed: "8.0.0"
-        notes: "iOS 9 and later does not use this constant anymore. Use the other available constants instead."
+        notes: "iOS 9 and later does not use this constant anymore. Use the other available `AUTHORIZATION_*` constants instead."
     since: "2.1.3"
 
   - name: AUTHORIZATION_UNKNOWN

diff --git a/apidoc/Titanium/Geolocation/Geolocation.yml b/apidoc/Titanium/Geolocation/Geolocation.yml
@@ -1278,9 +1278,7 @@ name: GeocodedAddress
 summary: |
     Simple object representing a place, returned in the callback from the
     [reverseGeocoder](Titanium.Geolocation.reverseGeocoder) method.
-
 properties:
-
   - name: street
     summary: Street name, without street address.
     type: String
@@ -1318,6 +1316,7 @@ properties:
     deprecated:
         since: {iphone: "8.0.0", ipad: "8.0.0"}
         removed: "9.0.0"
+        notes: Use the `postalCode` property for parity.
 
   - name: country
     summary: Country name.
@@ -1336,6 +1335,7 @@ properties:
     deprecated:
         since: {android: "8.0.0", iphone: "8.0.0", ipad: "8.0.0"}
         removed: "9.0.0"
+        notes: Use the `countryCode` property for parity.
 
   - name: longitude
     summary: Longitude of the geocoded point.
@@ -1354,6 +1354,7 @@ properties:
     deprecated:
         since: {android: "8.0.0"}
         removed: "9.0.0"
+        notes: Use the `address` property for parity.
 
   - name: address
     summary: Full address.

diff --git a/apidoc/Titanium/Gesture/Gesture.yml b/apidoc/Titanium/Gesture/Gesture.yml
@@ -14,7 +14,7 @@ methods:
     deprecated:
         since: "6.1.0"
         removed: "7.0.0"
-        notes: Use [Titanium.Gesture.landscape](Titanium.Gesture.landscape) for parity instead. Removed in 7.0.0 on Android, 8.1.0 on iOS.
+        notes: Use the [Titanium.Gesture.landscape](Titanium.Gesture.landscape) property for parity instead. Removed in 7.0.0 on Android, 8.1.0 on iOS.
     returns:
         type: Boolean
 
@@ -25,7 +25,7 @@ methods:
     deprecated:
         since: "6.1.0"
         removed: "7.0.0"
-        notes: Use [Titanium.Gesture.portrait](Titanium.Gesture.portrait) for parity instead. Removed in 7.0.0 on Android, 8.1.0 on iOS.
+        notes: Use the [Titanium.Gesture.portrait](Titanium.Gesture.portrait) property for parity instead. Removed in 7.0.0 on Android, 8.1.0 on iOS.
     returns:
         type: Boolean
 

diff --git a/apidoc/Titanium/Media/Media.yml b/apidoc/Titanium/Media/Media.yml
@@ -319,7 +319,7 @@ methods:
     deprecated:
       since: "5.1.0"
       removed: "9.0.0"
-      notes: Please use [Titanium.Media.requestCameraPermissions](Titanium.Media.requestCameraPermissions) instead.
+      notes: Please use the [Titanium.Media.requestCameraPermissions](Titanium.Media.requestCameraPermissions) method instead.
     summary: Requests for camera access.
     description: |
        This method allows the app to request for camera access, before or without the user granting
@@ -384,7 +384,7 @@ methods:
     deprecated:
         since: "5.1.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Media.requestAudioRecorderPermissions](Titanium.Media.requestAudioRecorderPermissions) instead.
+        notes: Use the [Titanium.Media.requestAudioRecorderPermissions](Titanium.Media.requestAudioRecorderPermissions) method instead.
     since: "3.1.3"
     parameters:
       - name: callback
@@ -447,7 +447,7 @@ methods:
     deprecated:
         since: "6.1.0"
         removed: "9.0.0"
-        notes: Use [Titanium.Media.requestAudioRecorderPermissions](Titanium.Media.requestAudioRecorderPermissions) instead.
+        notes: Use the [Titanium.Media.requestAudioRecorderPermissions](Titanium.Media.requestAudioRecorderPermissions) method instead.
     since: "5.1.0"
     parameters:
       - name: callback

diff --git a/apidoc/Titanium/Network/Socket/TCP.yml b/apidoc/Titanium/Network/Socket/TCP.yml
@@ -298,7 +298,6 @@ summary: Object passed to the error callback when the socket enters
     the [ERROR](Titanium.Network.Socket.ERROR) state.
 since: "1.7"
 extends: FailureResponse
-
 properties:
   - name: socket
     summary: Socket that experienced the error.
@@ -311,7 +310,7 @@ properties:
     deprecated:
         since: "3.1.0"
         removed: "9.0.0"
-        notes: Use the code property for a numeric error code
+        notes: Use the `code` property for a numeric error code.
 
   - name: success
     summary: Indicates if the operation succeeded. Returns `false`.

diff --git a/apidoc/Titanium/Stream/Stream.yml b/apidoc/Titanium/Stream/Stream.yml
@@ -322,7 +322,7 @@ properties:
     platforms: [android]
     deprecated:
         since: "3.1.0"
-        notes: Use success or code values to determine error conditions
+        notes: Use the `success` or `code` property values to determine error conditions.
         removed: "9.0.0"
 
   - name: errorDescription
@@ -331,7 +331,7 @@ properties:
     exclude-platforms: [macos]
     deprecated:
         since: "3.1.0"
-        notes: Use error property to determine error message
+        notes: Use the `error` property to determine error message.
         removed: "9.0.0"
 
   - name: success
@@ -381,7 +381,7 @@ properties:
     platforms: [android]
     deprecated:
         since: "3.1.0"
-        notes: Use success or code values to determine error conditions
+        notes: Use the `success` or `code` property values to determine error conditions.
         removed: "9.0.0"
 
   - name: errorDescription
@@ -390,7 +390,7 @@ properties:
     exclude-platforms: [macos]
     deprecated:
         since: "3.1.0"
-        notes: Use error property to determine error message
+        notes: Use the `error` property to determine the error message.
         removed: "9.0.0"
 
   - name: success

diff --git a/apidoc/Titanium/UI/Clipboard/Clipboard.yml b/apidoc/Titanium/UI/Clipboard/Clipboard.yml
@@ -28,8 +28,8 @@ description: |
     Any data type that is specified but not correctly mapped to a clipboard type by the system is
     retrieved as a <Titanium.Blob> type.
 extends: Titanium.Module
-platforms: [iphone, ipad, macos]
-since: {iphone: "1.5.0", ipad: "1.5.0", macos: "9.2.0"}
+platforms: [android, iphone, ipad, macos]
+since: {android: "1.8.0", iphone: "1.5.0", ipad: "1.5.0", macos: "9.2.0"}
 methods:
   - name: clearData
     summary: |
@@ -258,13 +258,13 @@ examples:
     example: |
         ``` js
         var clipboard1 = Ti.UI.createClipboard({
-            name : 'myClipboard',
-            allowCreation : true
+            name: 'myClipboard',
+            allowCreation: true
         });
         clipboard1.setText('hello');
 
         var clipboard2 = Ti.UI.createClipboard({
-            name : 'myClipboard'
+            name: 'myClipboard'
         });
 
         Ti.API.info('Clipboard name is: ' + clipboard1.name);
@@ -277,7 +277,7 @@ examples:
     example: |
         ``` js
         var clipboard = Ti.UI.createClipboard({
-            unique : true
+            unique: true
         });
         clipboard.setText('hello');
 

diff --git a/apidoc/Titanium/UI/Tab.yml b/apidoc/Titanium/UI/Tab.yml
@@ -315,7 +315,7 @@ events:
     deprecated:
         since: "5.2.0"
         removed: "9.0.0"
-        notes: Use [Titanium.UI.Tab.unselected](Titanium.UI.Tab.unselected) instead.
+        notes: Use [Titanium.UI.Tab.unselected](Titanium.UI.Tab.unselected) event instead.
     properties:
       - name: index
         summary: Index of the current active tab.
@@ -358,7 +358,7 @@ events:
     deprecated:
         since: "5.2.0"
         removed: "9.0.0"
-        notes: Use [Titanium.UI.Tab.selected](Titanium.UI.Tab.selected) instead.
+        notes: Use [Titanium.UI.Tab.selected](Titanium.UI.Tab.selected) event instead.
     properties:
       - name: index
         summary: Index of the current active tab.

diff --git a/apidoc/Titanium/UI/TabGroup.yml b/apidoc/Titanium/UI/TabGroup.yml
@@ -180,7 +180,7 @@ events:
     deprecated:
         since: "5.2.0"
         removed: "9.0.0"
-        notes: Use [Titanium.UI.Tab.focus](Titanium.UI.Tab.focus) instead.
+        notes: Use [Titanium.UI.Tab.focus](Titanium.UI.Tab.focus) event instead.
     properties:
       - name: index
         summary: Index of the current active tab.
@@ -206,7 +206,7 @@ events:
     deprecated:
         since: "5.2.0"
         removed: "9.0.0"
-        notes: Use [Titanium.UI.Tab.blur](Titanium.UI.Tab.blur) instead.
+        notes: Use [Titanium.UI.Tab.blur](Titanium.UI.Tab.blur) event instead.
     properties:
       - name: index
         summary: |

diff --git a/apidoc/Titanium/UI/WebView.yml b/apidoc/Titanium/UI/WebView.yml
@@ -535,7 +535,7 @@ events:
         deprecated:
             since: "3.1.0"
             removed: "9.0.0"
-            notes: Removed on ios in 8.0.0. Removed on android in 9.0.0.
+            notes: Use the `error` property instead. Removed on ios in 8.0.0. Removed on android in 9.0.0.
       - name: errorCode
         summary: A constant or underlying platform specific error code. Use code instead.
         type: Number
@@ -544,7 +544,7 @@ events:
         deprecated:
             since: "3.1.0"
             removed: "9.0.0"
-            notes: Removed on ios in 8.0.0. Removed on android in 9.0.0.
+            notes: Use the `code` property instead. Removed on ios in 8.0.0. Removed on android in 9.0.0.
 
   - name: load
     summary: Fired when the web view content is loaded.