@maccesar/titools 3.3.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/README.md +27 -61
  2. package/lib/cleanup.js +29 -0
  3. package/lib/commands/agents.js +8 -7
  4. package/lib/commands/skills.js +118 -23
  5. package/lib/config.js +13 -15
  6. package/lib/installer.js +5 -3
  7. package/lib/utils.js +36 -0
  8. package/package.json +1 -1
  9. package/skills/alloy-guides/SKILL.md +188 -0
  10. package/skills/alloy-guides/references/CLI_TASKS.md +233 -0
  11. package/skills/alloy-guides/references/CONCEPTS.md +171 -0
  12. package/skills/alloy-guides/references/CONTROLLERS.md +279 -0
  13. package/skills/alloy-guides/references/MODELS.md +742 -0
  14. package/skills/alloy-guides/references/MODELS_ADVANCED.md +482 -0
  15. package/skills/alloy-guides/references/PURGETSS.md +57 -0
  16. package/skills/alloy-guides/references/VIEWS_DYNAMIC.md +235 -0
  17. package/skills/alloy-guides/references/VIEWS_STYLES.md +375 -0
  18. package/skills/alloy-guides/references/VIEWS_WITHOUT_CONTROLLERS.md +102 -0
  19. package/skills/alloy-guides/references/VIEWS_XML.md +581 -0
  20. package/skills/alloy-guides/references/WIDGETS.md +160 -0
  21. package/skills/alloy-howtos/SKILL.md +179 -0
  22. package/skills/alloy-howtos/references/best_practices.md +121 -0
  23. package/skills/alloy-howtos/references/cli_reference.md +230 -0
  24. package/skills/alloy-howtos/references/config_files.md +158 -0
  25. package/skills/alloy-howtos/references/custom_tags.md +148 -0
  26. package/skills/alloy-howtos/references/debugging_troubleshooting.md +78 -0
  27. package/skills/alloy-howtos/references/samples.md +156 -0
  28. package/skills/purgetss/SKILL.md +6 -3
  29. package/skills/purgetss/references/EXAMPLES.md +8 -6
  30. package/skills/purgetss/references/app-branding.md +5 -0
  31. package/skills/purgetss/references/apply-directive.md +1 -1
  32. package/skills/purgetss/references/class-categories.md +1 -1
  33. package/skills/purgetss/references/class-index-properties.md +618 -0
  34. package/skills/purgetss/references/class-index.md +4 -610
  35. package/skills/purgetss/references/cli-commands.md +15 -0
  36. package/skills/purgetss/references/custom-fonts.md +39 -36
  37. package/skills/purgetss/references/custom-rules.md +1 -1
  38. package/skills/purgetss/references/customization-deep-dive.md +64 -1
  39. package/skills/purgetss/references/icon-fonts.md +2 -0
  40. package/skills/purgetss/references/migration-guide.md +53 -1
  41. package/skills/purgetss/references/multi-density-images.md +53 -2
  42. package/skills/purgetss/references/svg-pipeline.md +249 -0
  43. package/skills/purgetss/references/tikit-components.md +2 -2
  44. package/skills/purgetss/references/titanium-resets.md +2 -2
  45. package/skills/purgetss/references/ui-ux-design.md +7 -5
  46. package/skills/purgetss/references/version-history.md +12 -0
  47. package/skills/ti-api/SKILL.md +128 -0
  48. package/skills/ti-api/references/api-android.md +675 -0
  49. package/skills/ti-api/references/api-app-platform.md +636 -0
  50. package/skills/ti-api/references/api-core.md +764 -0
  51. package/skills/ti-api/references/api-data-network.md +641 -0
  52. package/skills/ti-api/references/api-media.md +655 -0
  53. package/skills/ti-api/references/api-modules-ble-bluetooth.md +657 -0
  54. package/skills/ti-api/references/api-modules-coremotion-urlsession.md +411 -0
  55. package/skills/ti-api/references/api-modules-map.md +632 -0
  56. package/skills/ti-api/references/api-modules-nfc.md +725 -0
  57. package/skills/ti-api/references/api-modules-social-misc.md +526 -0
  58. package/skills/ti-api/references/api-services.md +700 -0
  59. package/skills/ti-api/references/api-ui-android.md +499 -0
  60. package/skills/ti-api/references/api-ui-extras.md +702 -0
  61. package/skills/ti-api/references/api-ui-ios-animator.md +378 -0
  62. package/skills/ti-api/references/api-ui-ios.md +756 -0
  63. package/skills/ti-api/references/api-ui-lists.md +581 -0
  64. package/skills/ti-api/references/api-ui-text-input.md +607 -0
  65. package/skills/ti-api/references/api-ui-views.md +572 -0
  66. package/skills/ti-api/references/api-ui-windows-navigation.md +676 -0
  67. package/skills/ti-api/references/api-xml-global.md +743 -0
  68. package/skills/ti-guides/SKILL.md +82 -0
  69. package/skills/ti-guides/references/advanced-data-and-images.md +155 -0
  70. package/skills/ti-guides/references/android-manifest.md +97 -0
  71. package/skills/ti-guides/references/app-distribution.md +373 -0
  72. package/skills/ti-guides/references/application-frameworks.md +366 -0
  73. package/skills/ti-guides/references/cli-reference.md +700 -0
  74. package/skills/ti-guides/references/coding-best-practices.md +150 -0
  75. package/skills/ti-guides/references/commonjs-advanced.md +279 -0
  76. package/skills/ti-guides/references/hello-world.md +99 -0
  77. package/skills/ti-guides/references/hyperloop-native-access.md +458 -0
  78. package/skills/ti-guides/references/javascript-primer.md +402 -0
  79. package/skills/ti-guides/references/reserved-words.md +36 -0
  80. package/skills/ti-guides/references/resources.md +172 -0
  81. package/skills/ti-guides/references/style-and-conventions.md +104 -0
  82. package/skills/ti-guides/references/tiapp-config.md +655 -0
  83. package/skills/ti-howtos/SKILL.md +131 -0
  84. package/skills/ti-howtos/references/android-platform-deep-dives.md +609 -0
  85. package/skills/ti-howtos/references/automation-fastlane-appium.md +96 -0
  86. package/skills/ti-howtos/references/buffer-codec-streams.md +162 -0
  87. package/skills/ti-howtos/references/cross-platform-development.md +358 -0
  88. package/skills/ti-howtos/references/debugging-profiling.md +473 -0
  89. package/skills/ti-howtos/references/extending-titanium.md +684 -0
  90. package/skills/ti-howtos/references/google-maps-v2.md +172 -0
  91. package/skills/ti-howtos/references/ios-map-kit.md +149 -0
  92. package/skills/ti-howtos/references/ios-platform-deep-dives.md +595 -0
  93. package/skills/ti-howtos/references/local-data-sources.md +310 -0
  94. package/skills/ti-howtos/references/location-and-maps.md +267 -0
  95. package/skills/ti-howtos/references/media-apis.md +268 -0
  96. package/skills/ti-howtos/references/notification-services.md +539 -0
  97. package/skills/ti-howtos/references/remote-data-sources.md +339 -0
  98. package/skills/ti-howtos/references/tutorials.md +552 -0
  99. package/skills/ti-howtos/references/using-modules.md +182 -0
  100. package/skills/ti-howtos/references/web-content-integration.md +288 -0
  101. package/skills/ti-howtos/references/webpack-build-pipeline.md +125 -0
@@ -0,0 +1,636 @@
1
+ # Ti.App & Ti.Platform API Reference
2
+
3
+ ## Ti.App
4
+ > The top-level App module is mainly used for accessing information about the application at runtime, and for sending or listening for system events.
5
+ > Extends Ti.Module
6
+ > Platforms: both
7
+ > Type: module
8
+
9
+ ### Properties (unique: 21/26)
10
+ | Property | Type | Platform | Description |
11
+ |----------|------|----------|-------------|
12
+ | accessibilityEnabled | Boolean | both | Indicates whether Accessibility is enabled by the… |
13
+ | copyright | String | both | Application copyright statement, determined by `t… |
14
+ | currentService | Ti.App.iOS.BackgroundService | ios | A reference to the current background service run… |
15
+ | deployType | String | both | Build type that reflects how the application was … |
16
+ | description | String | both | Application description, determined by `tiapp.xml… |
17
+ | guid | String | both | Application globally-unique ID, determined by `ti… |
18
+ | forceSplashAsSnapshot | Boolean | ios | Shows the application's splash screen on app resu… |
19
+ | id | String | both | Application ID, from `tiapp.xml`. |
20
+ | installId | String | ios | The install ID for this application. |
21
+ | idleTimerDisabled | Boolean | ios | Determines whether the screen is locked when the … |
22
+ | name | String | both | Application name, determined by `tiapp.xml`. |
23
+ | proximityDetection | Boolean | both | Determines whether proximity detection is enabled. |
24
+ | proximityState | Boolean | both | Indicates the state of the device's proximity sen… |
25
+ | disableNetworkActivityIndicator | Boolean | ios | Prevents network activity indicator from being di… |
26
+ | publisher | String | both | Application publisher, from `tiapp.xml`. |
27
+ | sessionId | String | both | Unique session identifier for the current continu… |
28
+ | url | String | both | Application URL, from `tiapp.xml`. |
29
+ | version | String | both | Application version, from `tiapp.xml`. |
30
+ | keyboardVisible | Boolean | both | Indicates whether or not the soft keyboard is vis… |
31
+ | trackUserInteraction | Boolean | ios | Indicates whether or not the user interaction sho… |
32
+ | arguments | launchOptions | ios | The arguments passed to the application on startu… |
33
+
34
+ ### Constants (2)
35
+ - **EVENT_ACCESSIBILITY_\***: EVENT_ACCESSIBILITY_ANNOUNCEMENT, EVENT_ACCESSIBILITY_CHANGED
36
+
37
+
38
+ ### Methods (2)
39
+ | Method | Returns | Platform | Description |
40
+ |--------|---------|----------|-------------|
41
+ | fireSystemEvent(eventName, param) | void | both | Fire a system-level event such as <Titanium.App.E… |
42
+ | getArguments(—) | launchOptions | ios | Returns the arguments passed to the application o… |
43
+
44
+ ### Events (15)
45
+ | Event | Platform | Description |
46
+ |-------|----------|-------------|
47
+ | accessibilitychanged | both | Fired by the system when the device's accessibility service is turned on or off. |
48
+ | close | both | Fired by the system when the application is about to be terminated. |
49
+ | memorywarning | ios | Fired when the app receives a warning from the operating system about low memor… |
50
+ | pause | both | Fired when the application transitions from active to inactive state on a multi… |
51
+ | paused | both | Fired when the application transitions to the background on a multitasked syste… |
52
+ | proximity | both | Fired when the proximity sensor changes state. |
53
+ | screenshotcaptured | both | Fired after the user takes a screenshot, e.g. by pressing both the home and loc… |
54
+ | uncaughtException | both | Fired when an uncaught JavaScript exception occurs. |
55
+ | resume | both | Fired when the application returns to the foreground on a multitasked system. |
56
+ | resumed | both | Fired when the application returns to the foreground. |
57
+ | started | both | Fired after the "app.js" or "alloy.js" gets executed during application startup. |
58
+ | keyboardframechanged | both | Fired when the soft keyboard is presented, on and off the screen. |
59
+ | significanttimechange | ios | Fired when there is a significant change in the time. |
60
+ | shortcutitemclick | both | Fired when a <Titanium.UI.ShortcutItem> is clicked. |
61
+ | userinteraction | both | Called whenever an interaction with the window occurred. To be used together wi… |
62
+
63
+ ---
64
+
65
+ ## Ti.App.Android
66
+ > A module used to access Android application resources.
67
+ > Extends Ti.Module
68
+ > Platforms: android
69
+ > Type: module
70
+
71
+ ### Properties (unique: 4/7)
72
+ | Property | Type | Platform | Description |
73
+ |----------|------|----------|-------------|
74
+ | R | Ti.Android.R | android | The `R` namespace for application resources. |
75
+ | appVersionCode | Number | android | The version number of the application. |
76
+ | appVersionName | String | android | The version name of the application. |
77
+ | launchIntent | Ti.Android.Intent | android | Return the intent that was used to launch the app… |
78
+
79
+
80
+ ### Methods (1)
81
+ | Method | Returns | Platform | Description |
82
+ |--------|---------|----------|-------------|
83
+ | clearUserCache(—) | void | android | Clears app data and cache. This will close the ap… |
84
+
85
+ ### Events (1)
86
+ | Event | Platform | Description |
87
+ |-------|----------|-------------|
88
+ | shortcutitemclick | android | Fired when a <Titanium.UI.ShortcutItem> is clicked. |
89
+
90
+ ---
91
+
92
+ ## Ti.App.Properties
93
+ > The App Properties module is used for storing application-related data in property/value pairs that persist beyond application sessions and device power cycles.
94
+ > Extends Ti.Module
95
+ > Platforms: both
96
+ > Type: module
97
+
98
+
99
+ ### Methods (16)
100
+ | Method | Returns | Platform | Description |
101
+ |--------|---------|----------|-------------|
102
+ | getBool(property, default) | Boolean | both | Returns the value of a property as a boolean data… |
103
+ | getDouble(property, default) | Number | both | Returns the value of a property as a double (doub… |
104
+ | getInt(property, default) | Number | both | Returns the value of a property as an integer dat… |
105
+ | getList(property, default) | Array<Object> | both | Returns the value of a property as an array data … |
106
+ | getObject(property, default) | Object | both | Returns the value of a property as an object. |
107
+ | getString(property, default) | String | both | Returns the value of a property as a string data … |
108
+ | hasProperty(property) | Boolean | both | Indicates whether a property exists. |
109
+ | listProperties(—) | Array<Object> | both | Returns an array of property names. |
110
+ | removeProperty(property) | void | both | Removes a property if it exists, or does nothing … |
111
+ | removeAllProperties(—) | void | both | Removes all properties that have been set by the … |
112
+ | setBool(property, value) | void | both | Sets the value of a property as a boolean data ty… |
113
+ | setDouble(property, value) | void | both | Sets the value of a property as a double (double-… |
114
+ | setInt(property, value) | void | both | Sets the value of a property as an integer data t… |
115
+ | setList(property, value) | void | both | Sets the value of a property as an array data typ… |
116
+ | setObject(property, value) | void | both | Sets the value of a property as an object data ty… |
117
+ | setString(property, value) | void | both | Sets the value of a property as a string data typ… |
118
+
119
+ ### Events (1)
120
+ | Event | Platform | Description |
121
+ |-------|----------|-------------|
122
+ | change | ios | Fired when a property is changed. |
123
+
124
+ ---
125
+
126
+ ## Ti.App.iOS
127
+ > The top-level App iOS module, available only to iOS devices, that includes the facilities to create and manage local notifications and background services.
128
+ > Extends Ti.Module
129
+ > Platforms: ios
130
+ > Type: module
131
+
132
+ ### Properties (unique: 4/72)
133
+ | Property | Type | Platform | Description |
134
+ |----------|------|----------|-------------|
135
+ | currentUserNotificationSettings | UserNotificationSettings | ios | Notification types and user notification categori… |
136
+ | supportedUserActivityTypes | Array<String> | ios | Provides an Array of the NSUserActivityTypes keys… |
137
+ | applicationOpenSettingsURL | String | ios | Returns a URL to open the app's settings. |
138
+ | userInterfaceStyle | Number | ios | The style associated with the user interface. |
139
+
140
+ ### Constants (66)
141
+ - **BACKGROUNDFETCHINTERVAL_\***: BACKGROUNDFETCHINTERVAL_MIN, BACKGROUNDFETCHINTERVAL_NEVER
142
+ - **EVENT_ACCESSIBILITY_LAYOUT_\***: EVENT_ACCESSIBILITY_LAYOUT_CHANGED
143
+ - **EVENT_ACCESSIBILITY_SCREEN_\***: EVENT_ACCESSIBILITY_SCREEN_CHANGED
144
+ - **USER_INTERFACE_STYLE_\***: USER_INTERFACE_STYLE_UNSPECIFIED, USER_INTERFACE_STYLE_LIGHT, USER_INTERFACE_STYLE_DARK
145
+ - **USER_NOTIFICATION_ACTIVATION_MODE_\***: USER_NOTIFICATION_ACTIVATION_MODE_BACKGROUND, USER_NOTIFICATION_ACTIVATION_MODE_FOREGROUND
146
+ - **USER_NOTIFICATION_ALERT_STYLE_\***: USER_NOTIFICATION_ALERT_STYLE_NONE, USER_NOTIFICATION_ALERT_STYLE_ALERT, USER_NOTIFICATION_ALERT_STYLE_BANNER
147
+ - **USER_NOTIFICATION_AUTHORIZATION_STATUS_\***: USER_NOTIFICATION_AUTHORIZATION_STATUS_AUTHORIZED, USER_NOTIFICATION_AUTHORIZATION_STATUS_DENIED, USER_NOTIFICATION_AUTHORIZATION_STATUS_PROVISIONAL
148
+ - **USER_NOTIFICATION_AUTHORIZATION_STATUS_NOT_\***: USER_NOTIFICATION_AUTHORIZATION_STATUS_NOT_DETERMINED
149
+ - **USER_NOTIFICATION_BEHAVIOR_\***: USER_NOTIFICATION_BEHAVIOR_DEFAULT, USER_NOTIFICATION_BEHAVIOR_TEXTINPUT
150
+ - **USER_NOTIFICATION_CATEGORY_OPTION_\***: USER_NOTIFICATION_CATEGORY_OPTION_NONE
151
+ - **USER_NOTIFICATION_CATEGORY_OPTION_ALLOW_IN_\***: USER_NOTIFICATION_CATEGORY_OPTION_ALLOW_IN_CARPLAY
152
+ - **USER_NOTIFICATION_CATEGORY_OPTION_CUSTOM_DISMISS_\***: USER_NOTIFICATION_CATEGORY_OPTION_CUSTOM_DISMISS_ACTION
153
+ - **USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_\***: USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_TITLE, USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_SUBTITLE
154
+ - **USER_NOTIFICATION_SETTING_\***: USER_NOTIFICATION_SETTING_ENABLED, USER_NOTIFICATION_SETTING_DISABLED
155
+ - **USER_NOTIFICATION_SETTING_NOT_\***: USER_NOTIFICATION_SETTING_NOT_SUPPORTED
156
+ - **USER_NOTIFICATION_TYPE_\***: USER_NOTIFICATION_TYPE_NONE, USER_NOTIFICATION_TYPE_BADGE, USER_NOTIFICATION_TYPE_SOUND, USER_NOTIFICATION_TYPE_ALERT, USER_NOTIFICATION_TYPE_PROVISIONAL
157
+ - **USER_NOTIFICATION_TYPE_CRITICAL_\***: USER_NOTIFICATION_TYPE_CRITICAL_ALERT
158
+ - **USER_NOTIFICATION_TYPE_PROVIDES_APP_NOTIFICATION_\***: USER_NOTIFICATION_TYPE_PROVIDES_APP_NOTIFICATION_SETTINGS
159
+ - **UTTYPE_\***: UTTYPE_TEXT, UTTYPE_RTF, UTTYPE_HTML, UTTYPE_XML, UTTYPE_PDF, UTTYPE_RTFD, UTTYPE_IMAGE, UTTYPE_JPEG, UTTYPE_JPEG2000, UTTYPE_TIFF, UTTYPE_PICT, UTTYPE_GIF, UTTYPE_PNG, UTTYPE_BMP, UTTYPE_ICO, UTTYPE_MOVIE, UTTYPE_VIDEO, UTTYPE_AUDIO, UTTYPE_MPEG, UTTYPE_MPEG4, UTTYPE_MP3
160
+ - **UTTYPE_APPLE_\***: UTTYPE_APPLE_ICNS
161
+ - **UTTYPE_APPLE_PROTECTED_MPEG4_\***: UTTYPE_APPLE_PROTECTED_MPEG4_AUDIO
162
+ - **UTTYPE_FLAT_\***: UTTYPE_FLAT_RTFD
163
+ - **UTTYPE_MPEG4_\***: UTTYPE_MPEG4_AUDIO
164
+ - **UTTYPE_PLAIN_\***: UTTYPE_PLAIN_TEXT
165
+ - **UTTYPE_QUICKTIME_\***: UTTYPE_QUICKTIME_IMAGE, UTTYPE_QUICKTIME_MOVIE
166
+ - **UTTYPE_TXN_TEXT_AND_MULTIMEDIA_\***: UTTYPE_TXN_TEXT_AND_MULTIMEDIA_DATA
167
+ - **UTTYPE_UTF16_EXTERNAL_PLAIN_\***: UTTYPE_UTF16_EXTERNAL_PLAIN_TEXT
168
+ - **UTTYPE_UTF16_PLAIN_\***: UTTYPE_UTF16_PLAIN_TEXT
169
+ - **UTTYPE_UTF8_PLAIN_\***: UTTYPE_UTF8_PLAIN_TEXT
170
+ - **UTTYPE_WEB_\***: UTTYPE_WEB_ARCHIVE
171
+
172
+
173
+ ### Methods (11)
174
+ | Method | Returns | Platform | Description |
175
+ |--------|---------|----------|-------------|
176
+ | createUserDefaults(parameters) | Ti.App.iOS.UserDefaults | ios | Creates and returns an instance of Titanium.App.i… |
177
+ | cancelAllLocalNotifications(—) | void | ios | Cancels all scheduled local notifications. |
178
+ | cancelLocalNotification(id) | void | ios | Cancels a local notification. |
179
+ | registerBackgroundService(params) | Ti.App.iOS.BackgroundService | ios | Registers a service to run when the application i… |
180
+ | registerUserNotificationSettings(params) | void | ios | Registers the application to use the requested no… |
181
+ | scheduleLocalNotification(params) | Ti.App.iOS.LocalNotification | ios | Schedule a local notification. |
182
+ | setMinimumBackgroundFetchInterval(fetchInterval) | void | ios | Specifies the minimum amount of time that must el… |
183
+ | endBackgroundHandler(handlerID) | void | ios | Marks the end of the app execution after initiati… |
184
+ | sendWatchExtensionReply(handlerId, userInfo) | void | ios | Marks the end of an `openParentApplication:reply`… |
185
+ | createUserNotificationAction(parameters) | Ti.App.iOS.UserNotificationAction | ios | Creates and returns an instance of <Titanium.App.… |
186
+ | createUserNotificationCategory(parameters) | Ti.App.iOS.UserNotificationCategory | ios | Creates and returns an instance of <Titanium.App.… |
187
+
188
+ ### Events (18)
189
+ | Event | Platform | Description |
190
+ |-------|----------|-------------|
191
+ | notification | ios | Fired when a local notification is received by the application. |
192
+ | localnotificationaction | ios | Fired when a user selects an action for an interactive local notification. |
193
+ | remotenotificationaction | ios | Fired when a user selects an action for an interactive remote notification. |
194
+ | backgroundfetch | ios | Fired when the application is woken up for a fetch operation. Available only on… |
195
+ | silentpush | ios | Fired when the application is woken up by a silent remote notification. Availab… |
196
+ | backgroundtransfer | ios | Fired when the events related to a [urlSession](Modules.URLSession) are waiting… |
197
+ | downloadprogress | ios | Fired periodically to inform the app about the download's progress of a [urlSes… |
198
+ | uploadprogress | ios | Fired periodically to inform the app about the upload's progress of a [urlSessi… |
199
+ | downloadcompleted | ios | Fired to indicate that a [urlSession's](Modules.URLSession) download task has f… |
200
+ | sessioncompleted | ios | Fired to indicate that a [urlSession](Modules.URLSession) task finished transfe… |
201
+ | sessioneventscompleted | ios | Fired to indicate that all messages enqueued for a [urlSession](Modules.URLSess… |
202
+ | usernotificationsettings | ios | Fired when the user notification settings are registered. |
203
+ | watchkitextensionrequest | ios | Fired when openParentApplication:reply is called from a WatchKit extension. Ava… |
204
+ | continueactivity | ios | Fired when iOS continueactivity calls `continueUserActivity`. |
205
+ | shortcutitemclick | ios | Fired when a user taps the Application Shortcut. |
206
+ | handleurl | ios | Fired when a new URL is handled by the application. |
207
+ | traitcollectionchange | ios | Fired when the trait collection of the device changes, e.g. the user interface … |
208
+ | screenshotcaptured | ios | Fired after the user takes a screenshot, e.g. by pressing both the home and loc… |
209
+
210
+ ---
211
+
212
+ ## Ti.App.iOS.BackgroundService
213
+ > A service that runs when the application is placed in the background.
214
+ > Extends Ti.Proxy
215
+ > Platforms: ios
216
+
217
+ ### Properties (unique: 1/3)
218
+ | Property | Type | Platform | Description |
219
+ |----------|------|----------|-------------|
220
+ | url | String | ios | A local URL to a JavaScript file containing the c… |
221
+
222
+
223
+ ### Methods (2)
224
+ | Method | Returns | Platform | Description |
225
+ |--------|---------|----------|-------------|
226
+ | stop(—) | void | ios | Stops the service from running during the current… |
227
+ | unregister(—) | void | ios | Unregisters the background service. |
228
+
229
+
230
+ ---
231
+
232
+ ## Ti.App.iOS.LocalNotification
233
+ > A local notification to alert the user of new or pending application information.
234
+ > Extends Ti.Proxy
235
+ > Platforms: ios
236
+
237
+
238
+ ### Methods (1)
239
+ | Method | Returns | Platform | Description |
240
+ |--------|---------|----------|-------------|
241
+ | cancel(—) | void | ios | Cancels the pending notification. |
242
+
243
+
244
+ ---
245
+
246
+ ## Ti.App.iOS.SearchQuery
247
+ > A search query object manages the criteria to apply when searching app content that you have previously indexed by using the Core Spotlight APIs.
248
+ > Extends Ti.Proxy
249
+ > Platforms: ios
250
+
251
+ ### Properties (unique: 2/4)
252
+ | Property | Type | Platform | Description |
253
+ |----------|------|----------|-------------|
254
+ | queryString | String | ios | A formatted string that defines the matching crit… |
255
+ | attributes | Array<String> | ios | An array of strings that represent the attributes… |
256
+
257
+
258
+ ### Methods (3)
259
+ | Method | Returns | Platform | Description |
260
+ |--------|---------|----------|-------------|
261
+ | start(—) | void | ios | Asynchronously queries the index for items that m… |
262
+ | cancel(—) | void | ios | Cancels a query operation. |
263
+ | isCancelled(—) | Boolean | ios | A Boolean value that indicates if the query has b… |
264
+
265
+ ### Events (2)
266
+ | Event | Platform | Description |
267
+ |-------|----------|-------------|
268
+ | founditems | ios | Fired when the query finds a new batch of matching items. |
269
+ | completed | ios | Fired when the query completes to inform you about it's success. To receive ite… |
270
+
271
+ ---
272
+
273
+ ## Ti.App.iOS.SearchableIndex
274
+ > The SearchableIndex module is used to add or remove Ti.App.iOS.SearchableItem objects from the device search index.
275
+ > Extends Ti.Proxy
276
+ > Platforms: ios
277
+
278
+
279
+ ### Methods (5)
280
+ | Method | Returns | Platform | Description |
281
+ |--------|---------|----------|-------------|
282
+ | isSupported(—) | Boolean | ios | Indicates whether indexing is supported by the de… |
283
+ | addToDefaultSearchableIndex(Array, callback) | void | ios | Adds an array of Titanium.App.iOS.SearchableItem … |
284
+ | deleteAllSearchableItems(callback) | void | ios | Removes all search items added by the application. |
285
+ | deleteAllSearchableItemByDomainIdentifiers(Array, callback) | void | ios | Removes search items based on an array of domain … |
286
+ | deleteSearchableItemsByIdentifiers(Array, callback) | void | ios | Removes search items based on an array of identif… |
287
+
288
+
289
+ ---
290
+
291
+ ## Ti.App.iOS.SearchableItem
292
+ > Used to create a unique object containing all of the search information that will appear in the device search index.
293
+ > Extends Ti.Proxy
294
+ > Platforms: ios
295
+
296
+ ### Properties (unique: 4/6)
297
+ | Property | Type | Platform | Description |
298
+ |----------|------|----------|-------------|
299
+ | attributeSet | Ti.App.iOS.SearchableItemAttributeSet | ios | Set of metadata properties to display for the ite… |
300
+ | domainIdentifier | String | ios | Identifier that represents the "domain" or owner … |
301
+ | expirationDate | String | ios | Searchable items have an expiration date or time … |
302
+ | uniqueIdentifier | String | ios | Unique identifier to your application group. |
303
+
304
+
305
+
306
+
307
+ ---
308
+
309
+ ## Ti.App.iOS.SearchableItemAttributeSet
310
+ > The SearchableItemAttributeSet module defines metadata properties for SearchItem and UserActivity objects.
311
+ > Extends Ti.Proxy
312
+ > Platforms: ios
313
+
314
+ ### Properties (unique: 94/96)
315
+ | Property | Type | Platform | Description |
316
+ |----------|------|----------|-------------|
317
+ | itemContentType | String | ios | Content type of the attribute set. |
318
+ | displayName | String | ios | A localized string to be displayed in the UI for … |
319
+ | alternateNames | Array<String> | ios | An array of localized strings of alternate displa… |
320
+ | path | String | ios | The complete path to the item. |
321
+ | contentURL | String | ios | File URL representing the content to be indexed. |
322
+ | thumbnailURL | String | ios | File URL pointing to a thumbnail image for this i… |
323
+ | thumbnailData | String \| Ti.Blob | ios | Image data for thumbnail for this item. |
324
+ | relatedUniqueIdentifier | String | ios | For activities this is the unique identifier for … |
325
+ | metadataModificationDate | String | ios | The date that the last metadata attribute was cha… |
326
+ | contentType | String | ios | UTI Type pedigree for an item. |
327
+ | contentTypeTree | Array<String> | ios | Array of strings related to the content tree of t… |
328
+ | keywords | Array<String> | ios | Represents keywords associated with this particul… |
329
+ | title | String | ios | The title of the particular item. |
330
+ | subject | String | ios | Subject of the the item. |
331
+ | theme | String | ios | Theme of the the item. |
332
+ | contentDescription | String | ios | An account of the content of the resource. |
333
+ | identifier | String | ios | Used to reference to the resource within a given … |
334
+ | audiences | Array<String> | ios | A class of entity for whom the resource is intend… |
335
+ | fileSize | Number | ios | Size of the document in MB. |
336
+ | pageCount | Number | ios | Number of pages in the item. |
337
+ | pageWidth | Number | ios | Width in points (72 points per inch) of the docum… |
338
+ | pageHeight | Number | ios | Height in points (72 points per inch) of the docu… |
339
+ | securityMethod | String | ios | Security (encryption) method used in the file. |
340
+ | creator | String | ios | Application used to create the document content (… |
341
+ | encodingApplications | Array<String> | ios | Software used to convert the original content int… |
342
+ | kind | String | ios | Kind that the item represents. |
343
+ | fontNames | Array<String> | ios | Array of font names used in the item. |
344
+ | audioSampleRate | Number | ios | The sample rate of the audio data contained in th… |
345
+ | audioChannelCount | Number | ios | The number of channels in the audio data containe… |
346
+ | tempo | Number | ios | The tempo of the music contained in the audio fil… |
347
+ | keySignature | String | ios | The musical key of the song/composition contained… |
348
+ | timeSignature | String | ios | The time signature of the musical composition con… |
349
+ | audioEncodingApplication | String | ios | The name of the application that encoded the data… |
350
+ | composer | String | ios | The composer of the song/composition contained in… |
351
+ | lyricist | String | ios | The lyricist/text writer for song/composition con… |
352
+ | album | String | ios | The title for a collection of media. |
353
+ | artist | String | ios | The artist for the media. |
354
+ | audioTrackNumber | Number | ios | The track number of a song/composition when it is… |
355
+ | recordingDate | String | ios | The recording date of the song/composition. |
356
+ | musicalGenre | String | ios | The musical genre of the song/composition contain… |
357
+ | generalMIDISequence | Number | ios | Used to indicates whether the MIDI sequence conta… |
358
+ | musicalInstrumentCategory | String | ios | Metadata attribute that stores the category of in… |
359
+ | musicalInstrumentName | String | ios | Metadata attribute that stores the name of instru… |
360
+ | supportsPhoneCall | Number | ios | Used to indicate that using the phone number is a… |
361
+ | supportsNavigation | Number | ios | Used to determine if navigation is supported. |
362
+ | containerTitle | String | ios | Title displayed in the search container |
363
+ | containerDisplayName | String | ios | Display of the search container |
364
+ | containerIdentifier | String | ios | Identifier for the search container |
365
+ | containerOrder | Number | ios | Order the search container is displayed. |
366
+ | editors | Array<String> | ios | The list of editor/editors that have worked on th… |
367
+ | participants | Array<String> | ios | The list of people who are visible in an image or… |
368
+ | projects | Array<String> | ios | The list of projects that this item is part of. |
369
+ | downloadedDate | String | ios | The date that the file was last downloaded / rece… |
370
+ | lastUsedDate | String | ios | The date that the item was last used. |
371
+ | contentCreationDate | String | ios | The date that the contents of the item were creat… |
372
+ | contentModificationDate | String | ios | The date that the contents of the item were last … |
373
+ | addedDate | String | ios | The date that the item was moved into the current… |
374
+ | contentSources | Array<String> | ios | Used to indicate where the item was obtained from. |
375
+ | comment | String | ios | Comment related to a file. |
376
+ | copyright | String | ios | Copyright of the content. |
377
+ | duration | Number | ios | Duration in seconds of the content of the item (i… |
378
+ | contactKeywords | Array<String> | ios | A list of contacts that are somehow associated wi… |
379
+ | codecs | Array<String> | ios | The codecs used to encode/decode the media. |
380
+ | organizations | Array<String> | ios | Used to indicate company/Organization that create… |
381
+ | mediaTypes | Array<String> | ios | Media types present in the content. |
382
+ | version | String | ios | A version specifier for this item. |
383
+ | role | String | ios | Used to indicate the role of the document creator. |
384
+ | streamable | Number | ios | Whether the content is prepared for streaming. Se… |
385
+ | totalBitRate | Number | ios | The total bit rate (audio and video combined) of … |
386
+ | videoBitRate | Number | ios | The video bit rate. |
387
+ | audioBitRate | Number | ios | The audio bit rate. |
388
+ | deliveryType | Number | ios | The delivery type of the item. Set to `0` for fas… |
389
+ | languages | Array<String> | ios | Used to designate the languages of the intellectu… |
390
+ | rights | Array<String> | ios | Used to provide a link to information about right… |
391
+ | publishers | Array<String> | ios | Used to designate the entity responsible for maki… |
392
+ | contributors | Array<String> | ios | Used to designate the entity responsible for maki… |
393
+ | coverage | Array<String> | ios | Used to designate the extent or scope of the cont… |
394
+ | rating | Number | ios | User rating of this item out of 5 stars. |
395
+ | ratingDescription | String | ios | A description of the rating, for example, the num… |
396
+ | playCount | Number | ios | User play count of this item. |
397
+ | information | String | ios | Information about the item. |
398
+ | director | String | ios | Director of the item, for example, the movie dire… |
399
+ | producer | String | ios | Producer of the content. |
400
+ | genre | String | ios | Genre of the item, for example, movie genre. |
401
+ | performers | Array<String> | ios | Performers in the movie. |
402
+ | originalFormat | String | ios | Original format of the movie. |
403
+ | originalSource | String | ios | Original source of the movie. |
404
+ | local | Number | ios | Whether or not the item is local. Set to `1` if t… |
405
+ | contentRating | Number | ios | Whether or not the item has explicit content. Set… |
406
+ | url | String | ios | URL of the item. |
407
+ | fullyFormattedAddress | String | ios | The fully formatted address of the item (obtained… |
408
+ | subThoroughfare | String | ios | The sub-location (e.g., street number) for the it… |
409
+ | thoroughfare | String | ios | The location (e.g., street name) for the item acc… |
410
+ | postalCode | String | ios | The postal code for the item according to guideli… |
411
+
412
+
413
+
414
+
415
+ ---
416
+
417
+ ## Ti.App.iOS.UserActivity
418
+ > The UserActivity module is used to enable device Handoff and to create User Activities.
419
+ > Extends Ti.Proxy
420
+ > Platforms: ios
421
+
422
+ ### Properties (unique: 14/16)
423
+ | Property | Type | Platform | Description |
424
+ |----------|------|----------|-------------|
425
+ | activityType | String | ios | Name of the activity type. |
426
+ | eligibleForPublicIndexing | Boolean | ios | Set to `true` if the user activity can be publicl… |
427
+ | eligibleForSearch | Boolean | ios | Set to true if the user activity should be added … |
428
+ | eligibleForHandoff | Boolean | ios | Set to true if this user activity should be eligi… |
429
+ | eligibleForPrediction | Boolean | ios | A Boolean value that determines whether Siri can … |
430
+ | persistentIdentifier | String | ios | A value used to identify the user activity. |
431
+ | expirationDate | String | ios | Absolute date after which the activity is no long… |
432
+ | keywords | Array<String> | ios | An array of string keywords representing words or… |
433
+ | needsSave | Boolean | ios | Set to true every time you have updated the user … |
434
+ | requiredUserInfoKeys | Array<String> | ios | An array of String keys from the userInfo propert… |
435
+ | supported | Boolean | ios | Determines if user activities are supported (`tru… |
436
+ | title | String | ios | An optional, user-visible title for this activity… |
437
+ | userInfo | Dictionary | ios | The userInfo dictionary contains application-spec… |
438
+ | webpageURL | String | ios | When no suitable application is installed on a re… |
439
+
440
+
441
+ ### Methods (7)
442
+ | Method | Returns | Platform | Description |
443
+ |--------|---------|----------|-------------|
444
+ | addContentAttributeSet(contentAttributeSet) | void | ios | Adds a Titanium.App.iOS.SearchableItemAttributeSe… |
445
+ | becomeCurrent(—) | void | ios | Marks the activity as currently in use by the use… |
446
+ | invalidate(—) | void | ios | Invalidates an activity when it is no longer elig… |
447
+ | resignCurrent(—) | void | ios | Marks the activity as currently **not** in use an… |
448
+ | isSupported(—) | Boolean | ios | Determines if user activities are supported (`tru… |
449
+ | deleteSavedUserActivitiesForPersistentIdentifiers(persistentIdentifiers) | void | ios | Deletes user activities created by your app that … |
450
+ | deleteAllSavedUserActivities(—) | void | ios | Deletes all user activities created by your app. |
451
+
452
+ ### Events (3)
453
+ | Event | Platform | Description |
454
+ |-------|----------|-------------|
455
+ | useractivitywillsave | ios | Fired if the activity context needs to be saved before being continued on anoth… |
456
+ | useractivitywascontinued | ios | Fired when the user activity was continued on another device. |
457
+ | useractivitydeleted | ios | Fired when the user activity get deleted using the <Titanium.App.iOS.UserActivi… |
458
+
459
+ ---
460
+
461
+ ## Ti.App.iOS.UserDefaults
462
+ > The UserDefaults module is used for storing application-related data in property/value pairs that persist beyond application sessions and device power cycles. UserDefaults allows the suiteName of the UserDefaults to be specified at creation time. **Important**: Using this API requires the `NSPrivacyAccessedAPICategoryUserDefaults` property set in the privacy manifest that was introduced in iOS 17. You can learn more about it [here](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api).
463
+ > Extends Ti.App.Properties
464
+ > Platforms: ios
465
+ > Type: module
466
+
467
+ ### Properties (unique: 1/3)
468
+ | Property | Type | Platform | Description |
469
+ |----------|------|----------|-------------|
470
+ | suiteName | String | ios | Sets the name of the suite to be used to access U… |
471
+
472
+
473
+
474
+
475
+ ---
476
+
477
+ ## Ti.App.iOS.UserNotificationAction
478
+ > An action the user selects in response to an interactive notification.
479
+ > Extends Ti.Proxy
480
+ > Platforms: ios
481
+
482
+ ### Properties (unique: 6/7)
483
+ | Property | Type | Platform | Description |
484
+ |----------|------|----------|-------------|
485
+ | activationMode | Number | ios | Selects how to activate the application. |
486
+ | behavior | Number | ios | Custom behavior the user notification supports. |
487
+ | authenticationRequired | Boolean | ios | Set to true if the action requires the device to … |
488
+ | destructive | Boolean | ios | Set to true if the action causes destructive beha… |
489
+ | identifier | String | ios | Identifier for this action. Used to identify the … |
490
+ | title | String | ios | Title of the button displayed in the notification. |
491
+
492
+
493
+
494
+
495
+ ---
496
+
497
+ ## Ti.App.iOS.UserNotificationCategory
498
+ > A set of notification actions to associate with a notification.
499
+ > Extends Ti.Proxy
500
+ > Platforms: ios
501
+
502
+ ### Properties (unique: 7/8)
503
+ | Property | Type | Platform | Description |
504
+ |----------|------|----------|-------------|
505
+ | actionsForDefaultContext | Array<Titanium.App.iOS.UserNotificationAction> | ios | Array of notification actions to associate with t… |
506
+ | actionsForMinimalContext | Array<Titanium.App.iOS.UserNotificationAction> | ios | Array of notification actions to display for non-… |
507
+ | categorySummaryFormat | String | ios | A format string for the summary description used … |
508
+ | identifier | String | ios | Identifier for this category. |
509
+ | intentIdentifiers | Array<String> | ios | The intents related to notifications of this cate… |
510
+ | hiddenPreviewsBodyPlaceholder | String | ios | The placeholder text to display when notification… |
511
+ | options | Array<Number> | ios | Options for how to handle notifications of this t… |
512
+
513
+
514
+
515
+
516
+ ---
517
+
518
+ ## Ti.App.iOS.UserNotificationCenter
519
+ > The top-level App iOS Notification Center module. It is used to control scheduled notifications and receive details about the system-wide notification settings.
520
+ > Extends Ti.Module
521
+ > Platforms: ios
522
+ > Type: module
523
+
524
+
525
+ ### Methods (5)
526
+ | Method | Returns | Platform | Description |
527
+ |--------|---------|----------|-------------|
528
+ | getPendingNotifications(callback) | void | ios | Fetches the pending notifications asynchronously. |
529
+ | getDeliveredNotifications(callback) | void | ios | Fetches the delivered notifications asynchronousl… |
530
+ | removePendingNotifications(notifications) | void | ios | Removes the specified pending notifications to pr… |
531
+ | removeDeliveredNotifications(notifications) | void | ios | Removes the specified delivered notifications fro… |
532
+ | requestUserNotificationSettings(callback) | void | ios | Notification types and user notification categori… |
533
+
534
+
535
+ ---
536
+
537
+ ## Ti.Platform
538
+ > The top-level Platform module. The Platform module is used to access the device's platform-related functionality.
539
+ > Extends Ti.Module
540
+ > Platforms: both
541
+ > Type: module
542
+
543
+ ### Properties (unique: 29/36)
544
+ | Property | Type | Platform | Description |
545
+ |----------|------|----------|-------------|
546
+ | address | String | both | System's WIFI IP address. No other network types … |
547
+ | architecture | String | both | System's processor architecture. |
548
+ | availableMemory | Number | both | System's unused memory, measured in bytes. |
549
+ | batteryLevel | Number | both | Battery level in percent, accessible only when `b… |
550
+ | batteryMonitoring | Boolean | both | Determines whether battery monitoring is enabled. |
551
+ | batteryState | Number | both | Indicates the state of the battery. Accessible on… |
552
+ | displayCaps | Ti.Platform.DisplayCaps | both | Returns the DisplayCaps object. |
553
+ | id | String | both | Applications's globally-unique ID (UUID). |
554
+ | identifierForVendor | String | ios | An alphanumeric string that uniquely identifies a… |
555
+ | identifierForAdvertising | String | ios | An alphanumeric string unique to each device, use… |
556
+ | isAdvertisingTrackingEnabled | Boolean | ios | A Boolean value that indicates whether the user h… |
557
+ | isTranslatedBinaryOnAppleSilicon | Boolean | ios | A Boolean value that indicates whether the curren… |
558
+ | locale | String | both | System's default language. |
559
+ | macaddress | String | both | System's network interface mac address, or app UU… |
560
+ | manufacturer | String | both | Manufacturer of the device. |
561
+ | model | String | both | Model of the device. |
562
+ | name | String | both | Name of the platform. Returns `android` for the A… |
563
+ | netmask | String | both | System's WIFI network mask. No other network type… |
564
+ | osname | String | both | Short name of the system's Operating System. Retu… |
565
+ | ostype | String | both | Operating System architecture. On Android, this i… |
566
+ | processorCount | Number | both | Number of logical processing cores. |
567
+ | runtime | String | both | Short name of the JavaScript runtime in use. |
568
+ | totalMemory | Number | both | System's total memory, measured in bytes. |
569
+ | uptime | Number | both | System uptime since last boot in seconds. |
570
+ | username | String | both | System name, if set. On iOS, this can be found in… |
571
+ | version | String | both | The operating system's version string. |
572
+ | versionMajor | Number | both | The operating system's major version number. |
573
+ | versionMinor | Number | both | The operating system's minor version number. |
574
+ | versionPatch | Number | both | The operating system's patch version number. |
575
+
576
+ ### Constants (4)
577
+ - **BATTERY_STATE_\***: BATTERY_STATE_CHARGING, BATTERY_STATE_FULL, BATTERY_STATE_UNKNOWN, BATTERY_STATE_UNPLUGGED
578
+
579
+
580
+ ### Methods (5)
581
+ | Method | Returns | Platform | Description |
582
+ |--------|---------|----------|-------------|
583
+ | canOpenURL(url) | Boolean | both | Returns whether the system is configured with a d… |
584
+ | cpus(—) | Array<CPU> | android | Returns an array of basic CPU information for all… |
585
+ | createUUID(—) | String | both | Creates a globally-unique identifier. |
586
+ | openURL(url, options, callback) | Boolean | both | Opens this URL using the system's default applica… |
587
+ | is24HourTimeFormat(—) | Boolean | both | Returns whether the system settings are configure… |
588
+
589
+ ### Events (1)
590
+ | Event | Platform | Description |
591
+ |-------|----------|-------------|
592
+ | battery | both | Fired when the battery state changes. This is measured in 5% increments on iPho… |
593
+
594
+ ---
595
+
596
+ ## Ti.Platform.Android
597
+ > The Android-specific Platform module, used to access the device's platform-related functionality.
598
+ > Extends Ti.Module
599
+ > Platforms: android
600
+ > Type: module
601
+
602
+ ### Properties (unique: 1/10)
603
+ | Property | Type | Platform | Description |
604
+ |----------|------|----------|-------------|
605
+ | physicalSizeCategory | Number | android | The physical size category of the Android device … |
606
+
607
+ ### Constants (6)
608
+ - **API_\***: API_LEVEL
609
+ - **PHYSICAL_SIZE_CATEGORY_\***: PHYSICAL_SIZE_CATEGORY_LARGE, PHYSICAL_SIZE_CATEGORY_NORMAL, PHYSICAL_SIZE_CATEGORY_SMALL, PHYSICAL_SIZE_CATEGORY_UNDEFINED, PHYSICAL_SIZE_CATEGORY_XLARGE
610
+
611
+
612
+
613
+
614
+ ---
615
+
616
+ ## Ti.Platform.DisplayCaps
617
+ > The Display Caps object returned by the <Titanium.Platform.displayCaps> property.
618
+ > Extends Ti.Proxy
619
+ > Platforms: both
620
+
621
+ ### Properties (unique: 7/10)
622
+ | Property | Type | Platform | Description |
623
+ |----------|------|----------|-------------|
624
+ | density | String | both | Logical density of the display. |
625
+ | dpi | Number | both | Display density expressed as dots-per-inch. |
626
+ | logicalDensityFactor | Number | both | Logical density of the display, as a scaling fact… |
627
+ | platformHeight | Number | both | Absolute height of the display in relation to UI … |
628
+ | platformWidth | Number | both | Absolute width of the display in relation to UI o… |
629
+ | xdpi | Number | android | Physical pixels per inch of the display in the X … |
630
+ | ydpi | Number | android | Physical pixels per inch of the display in the Y … |
631
+
632
+
633
+
634
+
635
+ ---
636
+