@akylas/nativescript-cli 8.7.2

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 (531) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +385 -0
  3. package/bin/nativescript +3 -0
  4. package/bin/nativescript.js +3 -0
  5. package/bin/ns +3 -0
  6. package/bin/nsc +3 -0
  7. package/bin/nsc.js +3 -0
  8. package/bin/tns +12 -0
  9. package/bin/tns.cmd +1 -0
  10. package/config/config.json +8 -0
  11. package/config/test-dependencies.json +58 -0
  12. package/config/test-deps-versions-generated.json +1 -0
  13. package/docs/build-jekyll-md.sh +7 -0
  14. package/docs/helpers/favicon.ico +0 -0
  15. package/docs/helpers/logo.png +0 -0
  16. package/docs/man_pages/cloud/cloud-setup.md +29 -0
  17. package/docs/man_pages/device/device-android.md +32 -0
  18. package/docs/man_pages/device/device-ios.md +40 -0
  19. package/docs/man_pages/device/device-list-applications.md +37 -0
  20. package/docs/man_pages/device/device-log.md +37 -0
  21. package/docs/man_pages/device/device-run.md +55 -0
  22. package/docs/man_pages/device/device.md +46 -0
  23. package/docs/man_pages/env-configuration/setup.md +22 -0
  24. package/docs/man_pages/general/autocomplete-disable.md +37 -0
  25. package/docs/man_pages/general/autocomplete-enable.md +37 -0
  26. package/docs/man_pages/general/autocomplete-status.md +35 -0
  27. package/docs/man_pages/general/autocomplete.md +46 -0
  28. package/docs/man_pages/general/clean.md +22 -0
  29. package/docs/man_pages/general/doctor.md +33 -0
  30. package/docs/man_pages/general/error-reporting.md +41 -0
  31. package/docs/man_pages/general/extension-install.md +45 -0
  32. package/docs/man_pages/general/extension-uninstall.md +41 -0
  33. package/docs/man_pages/general/extension.md +35 -0
  34. package/docs/man_pages/general/help.md +39 -0
  35. package/docs/man_pages/general/info.md +33 -0
  36. package/docs/man_pages/general/migrate.md +79 -0
  37. package/docs/man_pages/general/package-manager-get.md +26 -0
  38. package/docs/man_pages/general/package-manager-set.md +29 -0
  39. package/docs/man_pages/general/package-manager.md +25 -0
  40. package/docs/man_pages/general/proxy-clear.md +26 -0
  41. package/docs/man_pages/general/proxy-set.md +45 -0
  42. package/docs/man_pages/general/proxy.md +31 -0
  43. package/docs/man_pages/general/update.md +40 -0
  44. package/docs/man_pages/general/usage-reporting.md +41 -0
  45. package/docs/man_pages/index.html +3 -0
  46. package/docs/man_pages/lib-management/plugin-add.md +42 -0
  47. package/docs/man_pages/lib-management/plugin-build.md +32 -0
  48. package/docs/man_pages/lib-management/plugin-create.md +48 -0
  49. package/docs/man_pages/lib-management/plugin-install.md +42 -0
  50. package/docs/man_pages/lib-management/plugin-remove.md +31 -0
  51. package/docs/man_pages/lib-management/plugin-update.md +41 -0
  52. package/docs/man_pages/lib-management/plugin.md +39 -0
  53. package/docs/man_pages/project/configuration/generate.md +36 -0
  54. package/docs/man_pages/project/configuration/install.md +43 -0
  55. package/docs/man_pages/project/configuration/open-android.md +27 -0
  56. package/docs/man_pages/project/configuration/open-ios.md +31 -0
  57. package/docs/man_pages/project/configuration/open.md +36 -0
  58. package/docs/man_pages/project/configuration/platform-add.md +46 -0
  59. package/docs/man_pages/project/configuration/platform-clean.md +41 -0
  60. package/docs/man_pages/project/configuration/platform-remove.md +41 -0
  61. package/docs/man_pages/project/configuration/platform-update.md +45 -0
  62. package/docs/man_pages/project/configuration/platform.md +29 -0
  63. package/docs/man_pages/project/configuration/prepare.md +49 -0
  64. package/docs/man_pages/project/configuration/resources/resources-generate-icons.md +39 -0
  65. package/docs/man_pages/project/configuration/resources/resources-generate-splashes.md +39 -0
  66. package/docs/man_pages/project/configuration/resources/resources-update.md +35 -0
  67. package/docs/man_pages/project/configuration/resources/resources.md +14 -0
  68. package/docs/man_pages/project/creation/create.md +64 -0
  69. package/docs/man_pages/project/testing/build-android.md +62 -0
  70. package/docs/man_pages/project/testing/build-ios.md +65 -0
  71. package/docs/man_pages/project/testing/build.md +66 -0
  72. package/docs/man_pages/project/testing/debug-android.md +64 -0
  73. package/docs/man_pages/project/testing/debug-ios.md +65 -0
  74. package/docs/man_pages/project/testing/debug.md +67 -0
  75. package/docs/man_pages/project/testing/deploy.md +72 -0
  76. package/docs/man_pages/project/testing/dev-test-android.md +31 -0
  77. package/docs/man_pages/project/testing/dev-test-ios.md +36 -0
  78. package/docs/man_pages/project/testing/preview.md +35 -0
  79. package/docs/man_pages/project/testing/run-android.md +79 -0
  80. package/docs/man_pages/project/testing/run-ios.md +83 -0
  81. package/docs/man_pages/project/testing/run.md +92 -0
  82. package/docs/man_pages/project/testing/test-android.md +46 -0
  83. package/docs/man_pages/project/testing/test-init.md +34 -0
  84. package/docs/man_pages/project/testing/test-ios.md +48 -0
  85. package/docs/man_pages/project/testing/test.md +48 -0
  86. package/docs/man_pages/project/testing/typings.md +52 -0
  87. package/docs/man_pages/publishing/apple-login.md +35 -0
  88. package/docs/man_pages/publishing/appstore-upload.md +52 -0
  89. package/docs/man_pages/publishing/appstore.md +42 -0
  90. package/docs/man_pages/publishing/publish-ios.md +55 -0
  91. package/docs/man_pages/publishing/publish.md +38 -0
  92. package/docs/man_pages/start.md +81 -0
  93. package/lib/.d.ts +494 -0
  94. package/lib/android-tools-info.js +135 -0
  95. package/lib/base-package-manager.js +129 -0
  96. package/lib/bash-scripts/terminateProcess.sh +12 -0
  97. package/lib/bootstrap.js +203 -0
  98. package/lib/bun-package-manager.js +135 -0
  99. package/lib/color.js +10 -0
  100. package/lib/commands/add-platform.js +49 -0
  101. package/lib/commands/apple-login.js +52 -0
  102. package/lib/commands/appstore-list.js +75 -0
  103. package/lib/commands/appstore-upload.js +106 -0
  104. package/lib/commands/build.js +161 -0
  105. package/lib/commands/clean.js +253 -0
  106. package/lib/commands/command-base.js +46 -0
  107. package/lib/commands/config.js +135 -0
  108. package/lib/commands/create-project.js +431 -0
  109. package/lib/commands/debug.js +191 -0
  110. package/lib/commands/deploy.js +78 -0
  111. package/lib/commands/extensibility/install-extension.js +33 -0
  112. package/lib/commands/extensibility/list-extensions.js +40 -0
  113. package/lib/commands/extensibility/uninstall-extension.js +32 -0
  114. package/lib/commands/fonts.js +64 -0
  115. package/lib/commands/generate-assets.js +71 -0
  116. package/lib/commands/generate-help.js +26 -0
  117. package/lib/commands/generate.js +78 -0
  118. package/lib/commands/info.js +26 -0
  119. package/lib/commands/install.js +80 -0
  120. package/lib/commands/list-platforms.js +45 -0
  121. package/lib/commands/migrate.js +44 -0
  122. package/lib/commands/platform-clean.js +54 -0
  123. package/lib/commands/plugin/add-plugin.js +43 -0
  124. package/lib/commands/plugin/build-plugin.js +70 -0
  125. package/lib/commands/plugin/create-plugin.js +175 -0
  126. package/lib/commands/plugin/list-plugins.js +54 -0
  127. package/lib/commands/plugin/remove-plugin.js +52 -0
  128. package/lib/commands/plugin/update-plugin.js +52 -0
  129. package/lib/commands/post-install.js +57 -0
  130. package/lib/commands/prepare.js +63 -0
  131. package/lib/commands/preview.js +93 -0
  132. package/lib/commands/remove-platform.js +40 -0
  133. package/lib/commands/resources/resources-update.js +45 -0
  134. package/lib/commands/run.js +177 -0
  135. package/lib/commands/setup.js +15 -0
  136. package/lib/commands/start.js +33 -0
  137. package/lib/commands/test-init.js +167 -0
  138. package/lib/commands/test.js +146 -0
  139. package/lib/commands/typings.js +180 -0
  140. package/lib/commands/update-platform.js +57 -0
  141. package/lib/commands/update.js +70 -0
  142. package/lib/common/LICENSE +201 -0
  143. package/lib/common/README.md +1084 -0
  144. package/lib/common/bin/common-lib.js +5 -0
  145. package/lib/common/bootstrap.js +97 -0
  146. package/lib/common/child-process.js +217 -0
  147. package/lib/common/codeGeneration/code-entity.js +47 -0
  148. package/lib/common/codeGeneration/code-generation.d.ts +47 -0
  149. package/lib/common/codeGeneration/code-printer.js +48 -0
  150. package/lib/common/command-params.js +45 -0
  151. package/lib/common/commands/analytics.js +81 -0
  152. package/lib/common/commands/autocompletion.js +110 -0
  153. package/lib/common/commands/device/device-log-stream.js +44 -0
  154. package/lib/common/commands/device/get-file.js +54 -0
  155. package/lib/common/commands/device/list-applications.js +42 -0
  156. package/lib/common/commands/device/list-devices.js +150 -0
  157. package/lib/common/commands/device/list-files.js +55 -0
  158. package/lib/common/commands/device/put-file.js +55 -0
  159. package/lib/common/commands/device/run-application.js +46 -0
  160. package/lib/common/commands/device/stop-application.js +42 -0
  161. package/lib/common/commands/device/uninstall-application.js +33 -0
  162. package/lib/common/commands/doctor.js +54 -0
  163. package/lib/common/commands/generate-messages.js +45 -0
  164. package/lib/common/commands/help.js +51 -0
  165. package/lib/common/commands/package-manager-get.js +32 -0
  166. package/lib/common/commands/package-manager-set.js +37 -0
  167. package/lib/common/commands/post-install.js +27 -0
  168. package/lib/common/commands/preuninstall.js +61 -0
  169. package/lib/common/commands/proxy/proxy-base.js +34 -0
  170. package/lib/common/commands/proxy/proxy-clear.js +32 -0
  171. package/lib/common/commands/proxy/proxy-get.js +31 -0
  172. package/lib/common/commands/proxy/proxy-set.js +150 -0
  173. package/lib/common/common-lib.js +5 -0
  174. package/lib/common/constants.js +122 -0
  175. package/lib/common/declarations.d.ts +1713 -0
  176. package/lib/common/decorators.js +201 -0
  177. package/lib/common/definitions/cli-global.d.ts +22 -0
  178. package/lib/common/definitions/commands-service.d.ts +27 -0
  179. package/lib/common/definitions/commands.d.ts +51 -0
  180. package/lib/common/definitions/config.d.ts +33 -0
  181. package/lib/common/definitions/extensibility.d.ts +147 -0
  182. package/lib/common/definitions/google-analytics.d.ts +109 -0
  183. package/lib/common/definitions/json-file-settings-service.d.ts +24 -0
  184. package/lib/common/definitions/key-commands.d.ts +62 -0
  185. package/lib/common/definitions/logger.d.ts +41 -0
  186. package/lib/common/definitions/mobile.d.ts +1499 -0
  187. package/lib/common/definitions/validator.d.ts +8 -0
  188. package/lib/common/definitions/yok.d.ts +56 -0
  189. package/lib/common/dispatchers.js +151 -0
  190. package/lib/common/docs/helpers/basic-extensions-page.html +15 -0
  191. package/lib/common/docs/helpers/basic-page.html +14 -0
  192. package/lib/common/docs/helpers/styles.css +365 -0
  193. package/lib/common/doctor.d.ts +6 -0
  194. package/lib/common/errors.js +206 -0
  195. package/lib/common/file-system.js +441 -0
  196. package/lib/common/header.js +30 -0
  197. package/lib/common/helpers.js +658 -0
  198. package/lib/common/host-info.js +133 -0
  199. package/lib/common/http-client.js +173 -0
  200. package/lib/common/logger/appenders/cli-appender.js +24 -0
  201. package/lib/common/logger/appenders/emit-appender.js +30 -0
  202. package/lib/common/logger/layouts/cli-layout.js +33 -0
  203. package/lib/common/logger/logger.js +199 -0
  204. package/lib/common/messages/messages.interface.d.ts +10 -0
  205. package/lib/common/messages/messages.js +15 -0
  206. package/lib/common/mobile/android/android-application-manager.js +228 -0
  207. package/lib/common/mobile/android/android-debug-bridge-result-handler.js +332 -0
  208. package/lib/common/mobile/android/android-debug-bridge.js +167 -0
  209. package/lib/common/mobile/android/android-device-file-system.js +176 -0
  210. package/lib/common/mobile/android/android-device-hash-service.js +133 -0
  211. package/lib/common/mobile/android/android-device.js +164 -0
  212. package/lib/common/mobile/android/android-emulator-services.js +205 -0
  213. package/lib/common/mobile/android/android-ini-file-parser.js +77 -0
  214. package/lib/common/mobile/android/android-log-filter.js +42 -0
  215. package/lib/common/mobile/android/android-virtual-device-service.js +360 -0
  216. package/lib/common/mobile/android/device-android-debug-bridge.js +48 -0
  217. package/lib/common/mobile/android/genymotion/genymotion-service.js +211 -0
  218. package/lib/common/mobile/android/genymotion/virtualbox-service.js +121 -0
  219. package/lib/common/mobile/android/logcat-helper.js +165 -0
  220. package/lib/common/mobile/application-manager-base.js +136 -0
  221. package/lib/common/mobile/device-emitter.js +61 -0
  222. package/lib/common/mobile/device-log-emitter.js +40 -0
  223. package/lib/common/mobile/device-log-provider-base.js +76 -0
  224. package/lib/common/mobile/device-log-provider.js +126 -0
  225. package/lib/common/mobile/device-platforms-constants.js +22 -0
  226. package/lib/common/mobile/emulator-helper.js +84 -0
  227. package/lib/common/mobile/ios/device/ios-application-manager.js +159 -0
  228. package/lib/common/mobile/ios/device/ios-device-file-system.js +133 -0
  229. package/lib/common/mobile/ios/device/ios-device-operations.js +234 -0
  230. package/lib/common/mobile/ios/device/ios-device.js +153 -0
  231. package/lib/common/mobile/ios/ios-device-base.js +108 -0
  232. package/lib/common/mobile/ios/ios-device-product-name-mapper.js +65 -0
  233. package/lib/common/mobile/ios/ios-log-filter.js +24 -0
  234. package/lib/common/mobile/ios/simulator/ios-emulator-services.js +139 -0
  235. package/lib/common/mobile/ios/simulator/ios-sim-resolver.js +23 -0
  236. package/lib/common/mobile/ios/simulator/ios-simulator-application-manager.js +147 -0
  237. package/lib/common/mobile/ios/simulator/ios-simulator-device.js +106 -0
  238. package/lib/common/mobile/ios/simulator/ios-simulator-file-system.js +81 -0
  239. package/lib/common/mobile/ios/simulator/ios-simulator-log-provider.js +69 -0
  240. package/lib/common/mobile/local-to-device-path-data-factory.js +37 -0
  241. package/lib/common/mobile/log-filter.js +51 -0
  242. package/lib/common/mobile/logging-levels.js +12 -0
  243. package/lib/common/mobile/mobile-core/android-device-discovery.js +91 -0
  244. package/lib/common/mobile/mobile-core/android-emulator-discovery.js +65 -0
  245. package/lib/common/mobile/mobile-core/android-process-service.js +259 -0
  246. package/lib/common/mobile/mobile-core/device-discovery.js +64 -0
  247. package/lib/common/mobile/mobile-core/devices-service.js +854 -0
  248. package/lib/common/mobile/mobile-core/ios-device-discovery.js +63 -0
  249. package/lib/common/mobile/mobile-core/ios-simulator-discovery.js +109 -0
  250. package/lib/common/mobile/mobile-helper.js +102 -0
  251. package/lib/common/mobile/wp8/wp8-emulator-services.js +82 -0
  252. package/lib/common/old.npmignore +12 -0
  253. package/lib/common/opener.js +16 -0
  254. package/lib/common/os-info.js +21 -0
  255. package/lib/common/plist-parser.js +24 -0
  256. package/lib/common/project-helper.js +70 -0
  257. package/lib/common/prompter.js +191 -0
  258. package/lib/common/queue.js +37 -0
  259. package/lib/common/resource-loader.js +25 -0
  260. package/lib/common/resources/messages/errorMessages.json +7 -0
  261. package/lib/common/resources/platform-tools/android/darwin/NOTICE.txt +3407 -0
  262. package/lib/common/resources/platform-tools/android/darwin/adb +0 -0
  263. package/lib/common/resources/platform-tools/android/linux/NOTICE.txt +4451 -0
  264. package/lib/common/resources/platform-tools/android/linux/adb +0 -0
  265. package/lib/common/resources/platform-tools/android/win32/AdbWinApi.dll +0 -0
  266. package/lib/common/resources/platform-tools/android/win32/AdbWinUsbApi.dll +0 -0
  267. package/lib/common/resources/platform-tools/android/win32/NOTICE.txt +4451 -0
  268. package/lib/common/resources/platform-tools/android/win32/adb.exe +0 -0
  269. package/lib/common/resources/platform-tools/android/win32/fastboot.exe +0 -0
  270. package/lib/common/resources/platform-tools/unzip/win32/unzip.exe +0 -0
  271. package/lib/common/services/analytics/google-analytics-custom-dimensions.d.ts +16 -0
  272. package/lib/common/services/auto-completion-service.js +265 -0
  273. package/lib/common/services/cancellation.js +67 -0
  274. package/lib/common/services/commands-service.js +268 -0
  275. package/lib/common/services/help-service.js +252 -0
  276. package/lib/common/services/hooks-service.js +318 -0
  277. package/lib/common/services/ios-notification-service.js +49 -0
  278. package/lib/common/services/json-file-settings-service.js +133 -0
  279. package/lib/common/services/lock-service.js +129 -0
  280. package/lib/common/services/message-contract-generator.js +83 -0
  281. package/lib/common/services/messages-service.js +77 -0
  282. package/lib/common/services/micro-templating-service.js +49 -0
  283. package/lib/common/services/net-service.js +137 -0
  284. package/lib/common/services/project-files-manager.js +100 -0
  285. package/lib/common/services/project-files-provider-base.js +54 -0
  286. package/lib/common/services/proxy-service.js +64 -0
  287. package/lib/common/services/qr.js +39 -0
  288. package/lib/common/services/settings-service.js +42 -0
  289. package/lib/common/services/xcode-select-service.js +62 -0
  290. package/lib/common/utils.js +31 -0
  291. package/lib/common/validators/project-name-validator.js +88 -0
  292. package/lib/common/validators/validation-result.js +16 -0
  293. package/lib/common/vendor/License.txt +4 -0
  294. package/lib/common/vendor/jaro-winkler_distance.js +111 -0
  295. package/lib/common/verify-node-version.js +78 -0
  296. package/lib/common/yok.js +426 -0
  297. package/lib/config.js +137 -0
  298. package/lib/constants-provider.js +12 -0
  299. package/lib/constants.js +350 -0
  300. package/lib/controllers/build-controller.js +133 -0
  301. package/lib/controllers/debug-controller.js +235 -0
  302. package/lib/controllers/deploy-controller.js +38 -0
  303. package/lib/controllers/migrate-controller.js +1114 -0
  304. package/lib/controllers/platform-controller.js +127 -0
  305. package/lib/controllers/prepare-controller.js +353 -0
  306. package/lib/controllers/run-controller.js +525 -0
  307. package/lib/controllers/update-controller-base.js +84 -0
  308. package/lib/controllers/update-controller.js +188 -0
  309. package/lib/data/build-data.js +44 -0
  310. package/lib/data/controller-data-base.js +11 -0
  311. package/lib/data/debug-data.js +6 -0
  312. package/lib/data/platform-data.js +13 -0
  313. package/lib/data/prepare-data.js +46 -0
  314. package/lib/data/run-data.js +11 -0
  315. package/lib/declarations.d.ts +1256 -0
  316. package/lib/definitions/android-bundle-tool-service.d.ts +17 -0
  317. package/lib/definitions/android-plugin-migrator.d.ts +52 -0
  318. package/lib/definitions/build.d.ts +92 -0
  319. package/lib/definitions/cleanup-service.d.ts +79 -0
  320. package/lib/definitions/data.d.ts +7 -0
  321. package/lib/definitions/debug.d.ts +166 -0
  322. package/lib/definitions/deploy.d.ts +3 -0
  323. package/lib/definitions/file-log-service.d.ts +19 -0
  324. package/lib/definitions/files-hash-service.d.ts +35 -0
  325. package/lib/definitions/gradle.d.ts +33 -0
  326. package/lib/definitions/hmr-status-service.d.ts +5 -0
  327. package/lib/definitions/initialize-service.d.ts +11 -0
  328. package/lib/definitions/ios-debugger-port-service.d.ts +29 -0
  329. package/lib/definitions/ios.d.ts +97 -0
  330. package/lib/definitions/ip-service.d.ts +10 -0
  331. package/lib/definitions/livesync-global.d.ts +7 -0
  332. package/lib/definitions/livesync.d.ts +601 -0
  333. package/lib/definitions/lock-service.d.ts +43 -0
  334. package/lib/definitions/log-parser-service.d.ts +14 -0
  335. package/lib/definitions/marking-mode-service.d.ts +11 -0
  336. package/lib/definitions/metadata-filtering-service.d.ts +48 -0
  337. package/lib/definitions/migrate.d.ts +46 -0
  338. package/lib/definitions/nativescript-dev-xcode.d.ts +87 -0
  339. package/lib/definitions/pacote-service.d.ts +50 -0
  340. package/lib/definitions/platform.d.ts +146 -0
  341. package/lib/definitions/plugins.d.ts +75 -0
  342. package/lib/definitions/prepare.d.ts +51 -0
  343. package/lib/definitions/project-changes.d.ts +34 -0
  344. package/lib/definitions/project.d.ts +858 -0
  345. package/lib/definitions/prompter.d.ts +27 -0
  346. package/lib/definitions/qr-code.d.ts +3 -0
  347. package/lib/definitions/require.d.ts +11 -0
  348. package/lib/definitions/run.d.ts +45 -0
  349. package/lib/definitions/start-service.d.ts +15 -0
  350. package/lib/definitions/subscription-service.d.ts +11 -0
  351. package/lib/definitions/system-warnings.d.ts +4 -0
  352. package/lib/definitions/temp-service.d.ts +9 -0
  353. package/lib/definitions/terminal-spinner-service.d.ts +12 -0
  354. package/lib/definitions/update.d.ts +16 -0
  355. package/lib/definitions/xcode.d.ts +12 -0
  356. package/lib/detached-processes/cleanup-js-subprocess.js +62 -0
  357. package/lib/detached-processes/cleanup-process-definitions.d.ts +70 -0
  358. package/lib/detached-processes/cleanup-process.js +281 -0
  359. package/lib/detached-processes/detached-process-enums.d.ts +70 -0
  360. package/lib/detached-processes/file-log-service.js +20 -0
  361. package/lib/device-path-provider.js +60 -0
  362. package/lib/device-sockets/ios/app-debug-socket-proxy-factory.js +217 -0
  363. package/lib/device-sockets/ios/notification.js +30 -0
  364. package/lib/device-sockets/ios/socket-request-executor.js +56 -0
  365. package/lib/helpers/android-bundle-validator-helper.js +52 -0
  366. package/lib/helpers/deploy-command-helper.js +70 -0
  367. package/lib/helpers/key-command-helper.js +124 -0
  368. package/lib/helpers/livesync-command-helper.js +220 -0
  369. package/lib/helpers/network-connectivity-validator.js +47 -0
  370. package/lib/helpers/options-track-helper.js +88 -0
  371. package/lib/helpers/package-path-helper.js +6 -0
  372. package/lib/helpers/platform-command-helper.js +192 -0
  373. package/lib/helpers/version-validator-helper.js +25 -0
  374. package/lib/key-commands/bootstrap.js +21 -0
  375. package/lib/key-commands/index.js +456 -0
  376. package/lib/nativescript-cli-lib-bootstrap.js +8 -0
  377. package/lib/nativescript-cli-lib.js +5 -0
  378. package/lib/nativescript-cli.js +55 -0
  379. package/lib/node/pbxproj-dom-xcode.js +5 -0
  380. package/lib/node/xcode.js +7 -0
  381. package/lib/node-package-manager.js +156 -0
  382. package/lib/options.js +393 -0
  383. package/lib/package-installation-manager.js +221 -0
  384. package/lib/package-manager.js +184 -0
  385. package/lib/platform-command-param.js +29 -0
  386. package/lib/pnpm-package-manager.js +136 -0
  387. package/lib/project-data.js +237 -0
  388. package/lib/providers/project-files-provider.js +46 -0
  389. package/lib/resolvers/livesync-service-resolver.js +22 -0
  390. package/lib/services/analytics/analytics-broker-process.js +77 -0
  391. package/lib/services/analytics/analytics-broker.js +53 -0
  392. package/lib/services/analytics/analytics-service.js +366 -0
  393. package/lib/services/analytics/analytics.d.ts +55 -0
  394. package/lib/services/analytics/google-analytics-cross-client-custom-dimensions.d.ts +6 -0
  395. package/lib/services/analytics/google-analytics-provider.js +152 -0
  396. package/lib/services/analytics-settings-service.js +104 -0
  397. package/lib/services/android/android-bundle-tool-service.js +81 -0
  398. package/lib/services/android/gradle-build-args-service.js +87 -0
  399. package/lib/services/android/gradle-build-service.js +68 -0
  400. package/lib/services/android/gradle-command-service.js +49 -0
  401. package/lib/services/android-device-debug-service.js +173 -0
  402. package/lib/services/android-plugin-build-service.js +527 -0
  403. package/lib/services/android-project-service.js +600 -0
  404. package/lib/services/android-resources-migration-service.js +104 -0
  405. package/lib/services/apple-portal/apple-portal-application-service.js +82 -0
  406. package/lib/services/apple-portal/apple-portal-cookie-service.js +53 -0
  407. package/lib/services/apple-portal/apple-portal-session-service.js +277 -0
  408. package/lib/services/apple-portal/definitions.d.ts +87 -0
  409. package/lib/services/assets-generation/assets-generation-service.js +178 -0
  410. package/lib/services/build-artifacts-service.js +113 -0
  411. package/lib/services/build-data-service.js +20 -0
  412. package/lib/services/build-info-file-service.js +79 -0
  413. package/lib/services/cleanup-service.js +194 -0
  414. package/lib/services/cocoapods-platform-manager.js +137 -0
  415. package/lib/services/cocoapods-service.js +354 -0
  416. package/lib/services/debug-data-service.js +21 -0
  417. package/lib/services/debug-service-base.js +44 -0
  418. package/lib/services/device/device-install-app-service.js +118 -0
  419. package/lib/services/doctor-service.js +294 -0
  420. package/lib/services/extensibility-service.js +220 -0
  421. package/lib/services/files-hash-service.js +79 -0
  422. package/lib/services/hmr-status-service.js +128 -0
  423. package/lib/services/info-service.js +14 -0
  424. package/lib/services/initialize-service.js +70 -0
  425. package/lib/services/ios/export-options-plist-service.js +131 -0
  426. package/lib/services/ios/ios-signing-service.js +265 -0
  427. package/lib/services/ios/spm-service.js +78 -0
  428. package/lib/services/ios/xcodebuild-args-service.js +163 -0
  429. package/lib/services/ios/xcodebuild-command-service.js +40 -0
  430. package/lib/services/ios/xcodebuild-service.js +93 -0
  431. package/lib/services/ios-debugger-port-service.js +140 -0
  432. package/lib/services/ios-device-debug-service.js +167 -0
  433. package/lib/services/ios-entitlements-service.js +78 -0
  434. package/lib/services/ios-extensions-service.js +63 -0
  435. package/lib/services/ios-log-filter.js +70 -0
  436. package/lib/services/ios-native-target-service.js +108 -0
  437. package/lib/services/ios-project-service.js +851 -0
  438. package/lib/services/ios-provision-service.js +173 -0
  439. package/lib/services/ios-watch-app-service.js +76 -0
  440. package/lib/services/ip-service.js +78 -0
  441. package/lib/services/itmstransporter-service.js +216 -0
  442. package/lib/services/karma-execution.js +16 -0
  443. package/lib/services/livesync/android-device-livesync-service-base.js +68 -0
  444. package/lib/services/livesync/android-device-livesync-service.js +203 -0
  445. package/lib/services/livesync/android-device-livesync-sockets-service.js +198 -0
  446. package/lib/services/livesync/android-livesync-service.js +76 -0
  447. package/lib/services/livesync/android-livesync-tool.js +427 -0
  448. package/lib/services/livesync/android-livesync-tool.md +211 -0
  449. package/lib/services/livesync/device-livesync-service-base.js +69 -0
  450. package/lib/services/livesync/ios-device-livesync-service.js +218 -0
  451. package/lib/services/livesync/ios-livesync-service.js +95 -0
  452. package/lib/services/livesync/livesync-socket.js +14 -0
  453. package/lib/services/livesync/platform-livesync-service-base.js +180 -0
  454. package/lib/services/livesync-process-data-service.js +43 -0
  455. package/lib/services/log-parser-service.js +52 -0
  456. package/lib/services/log-source-map-service.js +235 -0
  457. package/lib/services/marking-mode-service.js +56 -0
  458. package/lib/services/metadata-filtering-service.js +105 -0
  459. package/lib/services/npm-config-service.js +39 -0
  460. package/lib/services/pacote-service.js +109 -0
  461. package/lib/services/performance-service.js +92 -0
  462. package/lib/services/platform/add-platform-service.js +119 -0
  463. package/lib/services/platform/platform-validation-service.js +85 -0
  464. package/lib/services/platform/prepare-native-platform-service.js +87 -0
  465. package/lib/services/platform-environment-requirements.js +87 -0
  466. package/lib/services/platform-project-service-base.js +32 -0
  467. package/lib/services/platforms-data-service.js +31 -0
  468. package/lib/services/plugins-service.js +477 -0
  469. package/lib/services/prepare-data-service.js +21 -0
  470. package/lib/services/project-backup-service.js +114 -0
  471. package/lib/services/project-changes-service.js +274 -0
  472. package/lib/services/project-cleanup-service.js +102 -0
  473. package/lib/services/project-config-service.js +335 -0
  474. package/lib/services/project-data-service.js +478 -0
  475. package/lib/services/project-name-service.js +67 -0
  476. package/lib/services/project-service.js +204 -0
  477. package/lib/services/project-templates-service.js +114 -0
  478. package/lib/services/qr-code-terminal-service.js +20 -0
  479. package/lib/services/require-service.js +11 -0
  480. package/lib/services/start-service.js +116 -0
  481. package/lib/services/temp-service.js +36 -0
  482. package/lib/services/terminal-spinner-service.js +38 -0
  483. package/lib/services/test-execution-service.js +154 -0
  484. package/lib/services/test-initialization-service.js +54 -0
  485. package/lib/services/timeline-profiler-service.js +108 -0
  486. package/lib/services/user-settings-service.js +34 -0
  487. package/lib/services/versions-service.js +196 -0
  488. package/lib/services/watch-ignore-list-service.js +20 -0
  489. package/lib/services/webpack/webpack-compiler-service.js +405 -0
  490. package/lib/services/webpack/webpack.d.ts +227 -0
  491. package/lib/services/xcconfig-service.js +76 -0
  492. package/lib/services/xcproj-service.js +11 -0
  493. package/lib/shared-event-bus.js +7 -0
  494. package/lib/sys-info.js +120 -0
  495. package/lib/tools/config-manipulation/config-transformer.js +201 -0
  496. package/lib/tools/node-modules/node-modules-builder.js +42 -0
  497. package/lib/tools/node-modules/node-modules-dependencies-builder.js +100 -0
  498. package/lib/yarn-package-manager.js +134 -0
  499. package/lib/yarn2-package-manager.js +143 -0
  500. package/package.json +192 -0
  501. package/postinstall.js +10 -0
  502. package/preuninstall.js +14 -0
  503. package/resources/assets/image-definitions.json +655 -0
  504. package/resources/test/example.jasmine.js +6 -0
  505. package/resources/test/example.jasmine.ts +6 -0
  506. package/resources/test/example.mocha.js +9 -0
  507. package/resources/test/example.mocha.ts +9 -0
  508. package/resources/test/example.qunit.js +7 -0
  509. package/resources/test/example.qunit.ts +7 -0
  510. package/resources/test/karma.conf.js +93 -0
  511. package/resources/test/test-main.js +9 -0
  512. package/resources/test/test-main.ts +11 -0
  513. package/resources/test/tsconfig.spec.json +9 -0
  514. package/setup/mac-startup-shell-script.sh +2 -0
  515. package/vendor/aab-tool/LICENSE +202 -0
  516. package/vendor/aab-tool/README.txt +1 -0
  517. package/vendor/aab-tool/bundletool.jar +0 -0
  518. package/vendor/gradle-app/app/build.gradle +1054 -0
  519. package/vendor/gradle-app/app/gradle-helpers/AnalyticsCollector.gradle +48 -0
  520. package/vendor/gradle-app/app/gradle-helpers/BuildToolTask.gradle +50 -0
  521. package/vendor/gradle-app/app/gradle-helpers/CustomExecutionLogger.gradle +52 -0
  522. package/vendor/gradle-app/build.gradle +170 -0
  523. package/vendor/gradle-app/settings.gradle +78 -0
  524. package/vendor/gradle-plugin/LICENSE +995 -0
  525. package/vendor/gradle-plugin/build.gradle +363 -0
  526. package/vendor/gradle-plugin/gradle/wrapper/gradle-wrapper.jar +0 -0
  527. package/vendor/gradle-plugin/gradle/wrapper/gradle-wrapper.properties +6 -0
  528. package/vendor/gradle-plugin/gradle.properties +6 -0
  529. package/vendor/gradle-plugin/gradlew +172 -0
  530. package/vendor/gradle-plugin/gradlew.bat +84 -0
  531. package/vendor/gradle-plugin/settings.gradle +45 -0
@@ -0,0 +1,1499 @@
1
+ import { DeviceConnectionType } from "../../constants";
2
+ import { IProjectData } from "../../definitions/project";
3
+ import { IBuildData } from "../../definitions/build";
4
+ import {
5
+ IPlatform,
6
+ IDictionary,
7
+ IProjectDir,
8
+ IShouldDispose,
9
+ IStringDictionary,
10
+ IAppInstalledInfo,
11
+ IHasEmulatorOption,
12
+ IDisposable,
13
+ } from "../declarations";
14
+
15
+ declare global {
16
+ export module Mobile {
17
+ /**
18
+ * Describes available information for a device.
19
+ */
20
+ interface IDeviceInfo extends IPlatform {
21
+ /**
22
+ * Unique identifier of the device.
23
+ */
24
+ identifier: string;
25
+
26
+ /**
27
+ * The way we've discovered the device
28
+ */
29
+ connectionTypes: DeviceConnectionType[];
30
+
31
+ /**
32
+ * The name of the device.
33
+ * For Android this is the value of device's 'ro.product.name' property.
34
+ * For iOS this is the value of device's 'DeviceName' property.
35
+ */
36
+ displayName: string;
37
+
38
+ /**
39
+ * Device model.
40
+ * For Android this is the value of device's 'ro.product.model' property.
41
+ * For iOS this is the value of device's 'ProductType' property.
42
+ */
43
+ model: string;
44
+
45
+ /**
46
+ * Version of the OS.
47
+ * For Android this is the value of device's 'ro.build.version.release' property.
48
+ * For iOS this is the value of device's 'ProductVersion' property.
49
+ */
50
+ version: string;
51
+
52
+ /**
53
+ * Vendor of the device.
54
+ * For Android this is the value of device's 'ro.product.brand' property.
55
+ * For iOS the value is always "Apple".
56
+ */
57
+ vendor: string;
58
+
59
+ /**
60
+ * Status of device describing if you can work with this device or there's communication error.
61
+ * Can be Connected or Unauthorized.
62
+ */
63
+ status: string;
64
+
65
+ /**
66
+ * Additional information for errors that prevents working with this device.
67
+ * It will be null when status is Connected.
68
+ */
69
+ errorHelp: string;
70
+
71
+ /**
72
+ * Defines if the device is tablet or not.
73
+ * For Android the value will be true when device's 'ro.build.characteristics' property contains "tablet" word or when the 'ro.build.version.release' is 3.x
74
+ * For iOS the value will be true when device's 'ProductType' property contains "ipad" word.
75
+ */
76
+ isTablet: boolean;
77
+
78
+ /**
79
+ * Defines if the device is emulator or not.
80
+ * Can be "Device" or "Emulator"
81
+ */
82
+ type: string;
83
+
84
+ /**
85
+ * Optional property describing the color of the device.
86
+ * Available for iOS only - the value of device's 'DeviceColor' property.
87
+ */
88
+ color?: string;
89
+
90
+ /**
91
+ * Optional property describing the architecture of the device
92
+ * Available for iOS only - can be "armv7" or "arm64"
93
+ */
94
+ activeArchitecture?: string;
95
+ /**
96
+ * Available only for emulators. Should be null for devices.
97
+ * The identifier of the image. For geny emulators - the vm's identifier
98
+ * For avd emulators - the name of the .ini file
99
+ * For iOS simulators - same as the identifier.
100
+ */
101
+ imageIdentifier?: string;
102
+
103
+ /**
104
+ * Optional property describing the architecture of the device
105
+ * Available for Android only
106
+ */
107
+ abis?: string[];
108
+ }
109
+
110
+ interface IDeviceError extends Error, IDeviceIdentifier {}
111
+
112
+ interface IDeviceIdentifier {
113
+ deviceIdentifier: string;
114
+ }
115
+
116
+ interface IDevicesOperationError extends Error {
117
+ allErrors: IDeviceError[];
118
+ }
119
+
120
+ interface IDevice {
121
+ deviceInfo: Mobile.IDeviceInfo;
122
+ applicationManager: Mobile.IDeviceApplicationManager;
123
+ fileSystem: Mobile.IDeviceFileSystem;
124
+ isEmulator: boolean;
125
+ isOnlyWiFiConnected: boolean;
126
+ openDeviceLogStream(): Promise<void>;
127
+
128
+ /**
129
+ * Called when device is lost. Its purpose is to clean any resources used by the instance.
130
+ * @returns {void}
131
+ */
132
+ detach?(): void;
133
+ }
134
+
135
+ interface IiOSDevice extends IDevice {
136
+ getDebugSocket(
137
+ appId: string,
138
+ projectName: string,
139
+ projectDir: string,
140
+ ensureAppStarted?: boolean
141
+ ): Promise<any>;
142
+ destroyDebugSocket(appId: string): Promise<void>;
143
+ openDeviceLogStream(options?: IiOSLogStreamOptions): Promise<void>;
144
+ destroyAllSockets(): Promise<void>;
145
+ }
146
+
147
+ interface IAndroidDevice extends IDevice {
148
+ adb: Mobile.IDeviceAndroidDebugBridge;
149
+ init(): Promise<void>;
150
+ fileSystem: Mobile.IAndroidDeviceFileSystem;
151
+ }
152
+
153
+ interface IAndroidDeviceFileSystem extends IDeviceFileSystem {
154
+ getDeviceHashService(
155
+ appIdentifier: string
156
+ ): Mobile.IAndroidDeviceHashService;
157
+ }
158
+
159
+ /**
160
+ * Describes log stream options
161
+ */
162
+ interface IiOSLogStreamOptions {
163
+ /**
164
+ * This is the --predicate option which will be passed to `log stream` command
165
+ * log stream --predicate examples:
166
+ --predicate 'eventMessage contains "my message"'
167
+ --predicate 'eventType == logEvent and messageType == info'
168
+ --predicate 'processImagePath endswith "d"'
169
+ --predicate 'not processImagePath contains[c] "some spammer"'
170
+ --predicate 'processID < 100'
171
+ --predicate 'senderImagePath beginswith "my sender"'
172
+ --predicate 'eventType == logEvent and subsystem contains "com.example.my_subsystem"'
173
+ */
174
+ predicate?: string;
175
+ }
176
+
177
+ interface IDeviceAppData extends IPlatform, IConnectTimeoutOption {
178
+ appIdentifier: string;
179
+ device: Mobile.IDevice;
180
+ getDeviceProjectRootPath(): Promise<string>;
181
+ deviceSyncZipPath?: string;
182
+ projectDir: string;
183
+ }
184
+
185
+ interface ILogcatStartOptions {
186
+ deviceIdentifier: string;
187
+ pid?: string;
188
+ appId?: string;
189
+ keepSingleProcess?: boolean;
190
+
191
+ onAppRestarted?: () => void;
192
+ }
193
+
194
+ interface ILogcatHelper {
195
+ start(options: ILogcatStartOptions): Promise<void>;
196
+ stop(deviceIdentifier: string): void;
197
+ dump(deviceIdentifier: string): Promise<void>;
198
+ }
199
+
200
+ /**
201
+ * Describes methods for providing device logs to a specific consumer.
202
+ */
203
+ interface IDeviceLogProvider extends NodeJS.EventEmitter {
204
+ /**
205
+ * Sets the path to source file from which the logs are produced,
206
+ * i.e. the original file location of the file running on device.
207
+ * @param {string} pathToSourceFile Path to the source file.
208
+ * @returns {Promise<void>}
209
+ */
210
+ setSourceFileLocation(pathToSourceFile: string): Promise<void>;
211
+
212
+ /**
213
+ * Logs data in the specific way for the consumer.
214
+ * @param {string} line String from the device logs.
215
+ * @param {string} platform The platform of the device (for example iOS or Android).
216
+ * @param {string} deviceIdentifier The unique identifier of the device.
217
+ * @returns {void}
218
+ */
219
+ logData(line: string, platform: string, deviceIdentifier: string): void;
220
+
221
+ /**
222
+ * Sets the level of logging that will be used.
223
+ * @param {string} level The level of logs - could be INFO or FULL.
224
+ * @param {string} deviceIdentifier @optional The unique identifier of the device. When it is passed, only it's logging level is changed.
225
+ */
226
+ setLogLevel(level: string, deviceIdentifier?: string): void;
227
+
228
+ /**
229
+ * Sets the PID of the application on the specified device.
230
+ * @param {string} deviceIdentifier The unique identifier of the device.
231
+ * @param {string} pid The Process ID of the currently running application for which we need the logs.
232
+ */
233
+ setApplicationPidForDevice(deviceIdentifier: string, pid: string): void;
234
+
235
+ /**
236
+ * Sets the application id of the application on the specified device.
237
+ * @param {string} deviceIdentifier The unique identifier of the device.
238
+ * @param {string} appId The Process ID of the currently running application for which we need the logs.
239
+ */
240
+ setApplicationIdForDevice(deviceIdentifier: string, appId: string): void;
241
+
242
+ /**
243
+ * Sets the project name of the application on the specified device.
244
+ * @param {string} deviceIdentifier The unique identifier of the device.
245
+ * @param {string} projectName The project name of the currently running application for which we need the logs.
246
+ */
247
+ setProjectNameForDevice(
248
+ deviceIdentifier: string,
249
+ projectName: string
250
+ ): void;
251
+
252
+ /**
253
+ * Sets the project name of the application on the specified device.
254
+ * @param {string} deviceIdentifier The unique identifier of the device.
255
+ * @param {string} projectDir The project dir of the currently running application for which we need the logs.
256
+ */
257
+ setProjectDirForDevice(
258
+ deviceIdentifier: string,
259
+ projectDir: string
260
+ ): void;
261
+ }
262
+
263
+ /**
264
+ * Describes different options for filtering device logs.
265
+ */
266
+ interface IDeviceLogOptions
267
+ extends IDictionary<string | boolean>,
268
+ Partial<IProjectDir> {
269
+ /**
270
+ * Process id of the application on the device.
271
+ */
272
+ applicationPid?: string;
273
+
274
+ /**
275
+ * Selected log level for the current device. It can be INFO or FULL.
276
+ */
277
+ logLevel: string;
278
+
279
+ /**
280
+ * The project name.
281
+ */
282
+ projectName?: string;
283
+ /**
284
+ * The application id of the current app.
285
+ */
286
+ applicationId?: string;
287
+ }
288
+
289
+ /**
290
+ * Describes required methods for getting iOS Simulator's logs.
291
+ */
292
+ interface IiOSSimulatorLogProvider
293
+ extends NodeJS.EventEmitter,
294
+ IShouldDispose {
295
+ /**
296
+ * Starts the process for getting simulator logs and emits and DEVICE_LOG_EVENT_NAME event.
297
+ * @param {string} deviceId The unique identifier of the device.
298
+ * @param {Mobile.IiOSLogStreamOptions} options Describes the options which can be passed
299
+ */
300
+ startLogProcess(
301
+ deviceId: string,
302
+ options?: Mobile.IiOSLogStreamOptions
303
+ ): Promise<void>;
304
+ }
305
+
306
+ /**
307
+ * Describes common filtering rules for device logs.
308
+ */
309
+ interface ILogFilter {
310
+ /**
311
+ * The logging level that will be used for filtering in case logLevel is not passed to filterData method.
312
+ * Defaults to INFO.
313
+ */
314
+ loggingLevel: string;
315
+
316
+ /**
317
+ * Filters data for specified platform.
318
+ * @param {string} platform The platform for which is the device log.
319
+ * @param {string} data The input data for filtering.
320
+ * @param {Mobile.IDeviceLogOptions} deviceLogOptions The logging options based on which the filtering for this device logs will be executed.
321
+ * @return {string} The filtered result based on the input or null when the input data shouldn't be shown.
322
+ */
323
+ filterData(
324
+ platform: string,
325
+ data: string,
326
+ deviceLogOptions: Mobile.IDeviceLogOptions
327
+ ): string;
328
+ }
329
+
330
+ /**
331
+ * Replaces file paths in device log with their original location
332
+ */
333
+ interface ILogSourceMapService {
334
+ /**
335
+ * Sets the sourceMapConsumer instance for specified file.
336
+ * @param {string} filePath Full path to a local file containing both content and inline source map.
337
+ * @return {Promise<void>}
338
+ */
339
+ setSourceMapConsumerForFile(filePath: string): Promise<void>;
340
+ replaceWithOriginalFileLocations(
341
+ platform: string,
342
+ messageData: string,
343
+ loggingOptions: Mobile.IDeviceLogOptions
344
+ ): string;
345
+ }
346
+
347
+ /**
348
+ * Describes filtering logic for specific platform (Android, iOS).
349
+ */
350
+ interface IPlatformLogFilter {
351
+ /**
352
+ * Filters passed string data based on the passed logging level.
353
+ * @param {string} data The string data that will be checked based on the logging level.
354
+ * @param {string} logLevel Selected logging level.
355
+ * @param {string} pid The Process ID of the currently running application for which we need the logs.
356
+ * @return {string} The filtered result based on the input or null when the input data shouldn't be shown.
357
+ */
358
+ filterData(
359
+ data: string,
360
+ deviceLogOptions: Mobile.IDeviceLogOptions
361
+ ): string;
362
+ }
363
+
364
+ interface ILoggingLevels {
365
+ info: string;
366
+ full: string;
367
+ }
368
+
369
+ interface IApplicationData extends IProjectDir {
370
+ appId: string;
371
+ projectName: string;
372
+ justLaunch?: boolean;
373
+ }
374
+
375
+ interface IStartApplicationData extends IApplicationData {
376
+ waitForDebugger?: boolean;
377
+ }
378
+
379
+ interface IInstallAppData extends IApplicationData {
380
+ packagePath: string;
381
+ }
382
+
383
+ interface IDeviceApplicationManager extends NodeJS.EventEmitter {
384
+ getInstalledApplications(): Promise<string[]>;
385
+ isApplicationInstalled(appIdentifier: string): Promise<boolean>;
386
+ installApplication(
387
+ packageFilePath: string,
388
+ appIdentifier?: string,
389
+ buildData?: IBuildData
390
+ ): Promise<void>;
391
+ uninstallApplication(appIdentifier: string): Promise<void>;
392
+ reinstallApplication(
393
+ appIdentifier: string,
394
+ packageFilePath: string,
395
+ buildData?: IBuildData
396
+ ): Promise<void>;
397
+ startApplication(appData: IStartApplicationData): Promise<void>;
398
+ stopApplication(appData: IApplicationData): Promise<void>;
399
+ restartApplication(appData: IStartApplicationData): Promise<void>;
400
+ checkForApplicationUpdates(): Promise<void>;
401
+ tryStartApplication(appData: IApplicationData): Promise<void>;
402
+ getDebuggableApps(): Promise<Mobile.IDeviceApplicationInformation[]>;
403
+ getDebuggableAppViews(
404
+ appIdentifiers: string[]
405
+ ): Promise<IDictionary<Mobile.IDebugWebViewInfo[]>>;
406
+ /**
407
+ * Sets the files transferred on device.
408
+ * @param {string[]} files Local paths to files transferred on device.
409
+ * @returns {Promise<void>}
410
+ */
411
+ setTransferredAppFiles(files: string[]): Promise<void>;
412
+ }
413
+
414
+ /**
415
+ * Describes information about an application.
416
+ */
417
+ interface IApplicationInfo {
418
+ /**
419
+ * Application's identifier
420
+ * @type {string}
421
+ */
422
+ applicationIdentifier: string;
423
+
424
+ /**
425
+ * Device's identifier
426
+ * @type {string}
427
+ */
428
+ deviceIdentifier?: string;
429
+ /**
430
+ * The configuration of the currently deployed application (e.g. debug, release, live, etc.)
431
+ * @type {string}
432
+ */
433
+ configuration: string;
434
+ }
435
+
436
+ interface IDeviceFileSystem {
437
+ listFiles(devicePath: string, appIdentifier?: string): Promise<any>;
438
+ getFile(
439
+ deviceFilePath: string,
440
+ appIdentifier: string,
441
+ outputFilePath?: string
442
+ ): Promise<void>;
443
+ getFileContent(
444
+ deviceFilePath: string,
445
+ appIdentifier: string
446
+ ): Promise<string>;
447
+ putFile(
448
+ localFilePath: string,
449
+ deviceFilePath: string,
450
+ appIdentifier: string
451
+ ): Promise<void>;
452
+ deleteFile(deviceFilePath: string, appIdentifier: string): Promise<void>;
453
+ transferFiles(
454
+ deviceAppData: Mobile.IDeviceAppData,
455
+ localToDevicePaths: Mobile.ILocalToDevicePathData[]
456
+ ): Promise<Mobile.ILocalToDevicePathData[]>;
457
+ transferDirectory(
458
+ deviceAppData: Mobile.IDeviceAppData,
459
+ localToDevicePaths: Mobile.ILocalToDevicePathData[],
460
+ projectFilesPath: string
461
+ ): Promise<Mobile.ILocalToDevicePathData[]>;
462
+ transferFile?(
463
+ localFilePath: string,
464
+ deviceFilePath: string
465
+ ): Promise<void>;
466
+ createFileOnDevice?(
467
+ deviceFilePath: string,
468
+ fileContent: string
469
+ ): Promise<void>;
470
+ /**
471
+ * Updates the hash file on device with the current hashes of files.
472
+ * @param hashes - All file's hashes
473
+ * @param appIdentifier - The identifier of the application.
474
+ */
475
+ updateHashesOnDevice(
476
+ hashes: IStringDictionary,
477
+ appIdentifier: string
478
+ ): Promise<void>;
479
+ }
480
+
481
+ interface IAndroidDebugBridgeCommandOptions {
482
+ fromEvent?: string;
483
+ returnChildProcess?: boolean;
484
+ treatErrorsAsWarnings?: boolean;
485
+ childProcessOptions?: any;
486
+ deviceIdentifier?: string;
487
+ }
488
+
489
+ interface IAndroidDebugBridge {
490
+ executeCommand(
491
+ args: string[],
492
+ options?: IAndroidDebugBridgeCommandOptions
493
+ ): Promise<any>;
494
+ executeShellCommand(
495
+ args: string[],
496
+ options?: IAndroidDebugBridgeCommandOptions
497
+ ): Promise<any>;
498
+ pushFile(localFilePath: string, deviceFilePath: string): Promise<void>;
499
+ removeFile(deviceFilePath: string): Promise<void>;
500
+ /**
501
+ * Gets the property value from device
502
+ * @param deviceId The identifier of device
503
+ * @param propertyName The name of the property
504
+ * @returns {Promise<string>} Returns the property's value
505
+ */
506
+ getPropertyValue(deviceId: string, propertyName: string): Promise<string>;
507
+ /**
508
+ * Gets all connected android devices
509
+ * @returns {Promise<string>} Returns all connected android devices
510
+ */
511
+ getDevices(): Promise<string[]>;
512
+
513
+ /**
514
+ * Returns current Android devices or empty array in case of an error.
515
+ * @returns {Promise<string[]>} Array of currently running devices.
516
+ */
517
+ getDevicesSafe(): Promise<string[]>;
518
+ }
519
+
520
+ interface IDeviceAndroidDebugBridge extends IAndroidDebugBridge {
521
+ sendBroadcastToDevice(
522
+ action: string,
523
+ extras?: IStringDictionary
524
+ ): Promise<number>;
525
+ }
526
+
527
+ interface IDeviceDiscovery extends NodeJS.EventEmitter {
528
+ startLookingForDevices(options?: IDeviceLookingOptions): Promise<void>;
529
+ }
530
+
531
+ interface IiOSSimulatorDiscovery extends IDeviceDiscovery {
532
+ checkForAvailableSimulators(): Promise<void>;
533
+ }
534
+
535
+ interface IAndroidDeviceDiscovery extends IDeviceDiscovery {
536
+ ensureAdbServerStarted(): Promise<any>;
537
+ }
538
+
539
+ /**
540
+ * Describes options that can be passed to devices service's initialization method.
541
+ */
542
+ interface IDevicesServicesInitializationOptions
543
+ extends Partial<IDeviceLookingOptions> {
544
+ /**
545
+ * If passed will start an emulator if necesasry.
546
+ */
547
+ emulator?: boolean;
548
+ /**
549
+ * Specifies a device with which to work with.
550
+ */
551
+ deviceId?: string;
552
+ /**
553
+ * Specifies that platform should not be infered. That is to say that all devices will be detected regardless of platform and no errors will be thrown.
554
+ */
555
+ skipInferPlatform?: boolean;
556
+ /**
557
+ * If passed along with skipInferPlatform then the device detection interval will not be started but instead the currently attached devices will be detected.
558
+ */
559
+ skipDeviceDetectionInterval?: boolean;
560
+ /**
561
+ * Specifies whether we should skip the emulator starting.
562
+ */
563
+ skipEmulatorStart?: boolean;
564
+ /**
565
+ * Currently available only for iOS. Specifies the sdk version of the iOS simulator.
566
+ * In case when `tns run ios --device "iPhone 6"` command is executed, the user can specify the sdk of the simulator because it is possible to have more than one device with the same name but with different sdk versions.
567
+ */
568
+ sdk?: string;
569
+
570
+ /**
571
+ * Don't stop on the first iOS device
572
+ */
573
+ fullDiscovery?: boolean;
574
+ }
575
+
576
+ interface IDeviceActionResult<T> extends IDeviceIdentifier {
577
+ result: T;
578
+ }
579
+
580
+ /**
581
+ * Describes a projectIdentifier for both platforms.
582
+ */
583
+ interface IProjectIdentifier {
584
+ ios: string;
585
+ android: string;
586
+ [platform: string]: string;
587
+ }
588
+
589
+ interface IDevicesService extends NodeJS.EventEmitter, IPlatform {
590
+ hasDevices: boolean;
591
+ deviceCount: number;
592
+
593
+ execute<T>(
594
+ action: (device: Mobile.IDevice) => Promise<T>,
595
+ canExecute?: (dev: Mobile.IDevice) => boolean,
596
+ options?: { allowNoDevices?: boolean }
597
+ ): Promise<IDeviceActionResult<T>[]>;
598
+
599
+ /**
600
+ * Initializes DevicesService, so after that device operations could be executed.
601
+ * @param {IDevicesServicesInitializationOptions} data Defines the options which will be used for whole devicesService.
602
+ * @return {Promise<void>}
603
+ */
604
+ initialize(data?: IDevicesServicesInitializationOptions): Promise<void>;
605
+
606
+ /**
607
+ * Add an IDeviceDiscovery instance which will from now on report devices. The instance should implement IDeviceDiscovery and raise "deviceFound" and "deviceLost" events.
608
+ * @param {IDeviceDiscovery} deviceDiscovery Instance, implementing IDeviceDiscovery and raising raise "deviceFound" and "deviceLost" events.
609
+ * @return {void}
610
+ */
611
+ addDeviceDiscovery(deviceDiscovery: IDeviceDiscovery): void;
612
+ getDevices(): Mobile.IDeviceInfo[];
613
+
614
+ /**
615
+ * Gets device instance by specified identifier or number.
616
+ * @param {string} deviceOption The specified device identifier or number.
617
+ * @returns {Promise<Mobile.IDevice>} Instance of IDevice.
618
+ */
619
+ getDevice(deviceOption: string): Promise<Mobile.IDevice>;
620
+ getDevicesForPlatform(platform: string): Mobile.IDevice[];
621
+ getDeviceInstances(): Mobile.IDevice[];
622
+ getDeviceByDeviceOption(): Mobile.IDevice;
623
+ isAndroidDevice(device: Mobile.IDevice): boolean;
624
+ isiOSDevice(device: Mobile.IDevice): boolean;
625
+ isiOSSimulator(device: Mobile.IDevice): boolean;
626
+ isOnlyiOSSimultorRunning(): boolean;
627
+ isAppInstalledOnDevices(
628
+ deviceIdentifiers: string[],
629
+ appIdentifier: string,
630
+ framework: string,
631
+ projectDir: string
632
+ ): Promise<IAppInstalledInfo>[];
633
+ setLogLevel(logLevel: string, deviceIdentifier?: string): void;
634
+ deployOnDevices(
635
+ deviceIdentifiers: string[],
636
+ packageFile: string,
637
+ packageName: string,
638
+ framework: string,
639
+ projectDir: string
640
+ ): Promise<void>[];
641
+ getDeviceByIdentifier(identifier: string): Mobile.IDevice;
642
+ mapAbstractToTcpPort(
643
+ deviceIdentifier: string,
644
+ appIdentifier: string,
645
+ framework: string
646
+ ): Promise<string>;
647
+ getDebuggableApps(
648
+ deviceIdentifiers: string[]
649
+ ): Promise<Mobile.IDeviceApplicationInformation[]>[];
650
+ getDebuggableViews(
651
+ deviceIdentifier: string,
652
+ appIdentifier: string
653
+ ): Promise<Mobile.IDebugWebViewInfo[]>;
654
+
655
+ /**
656
+ * Returns all applications installed on the specified device.
657
+ * @param {string} deviceIdentifer The identifier of the device for which to get installed applications.
658
+ * @returns {Promise<string[]>} Array of all application identifiers of the apps installed on device.
659
+ */
660
+ getInstalledApplications(deviceIdentifier: string): Promise<string[]>;
661
+
662
+ /**
663
+ * Returns all available iOS and/or Android emulators.
664
+ * @param options The options that can be passed to filter the result.
665
+ * @returns {Promise<Mobile.IListEmulatorsOutput>} Dictionary with the following format: { ios: { devices: Mobile.IDeviceInfo[], errors: string[] }, android: { devices: Mobile.IDeviceInfo[], errors: string[]}}.
666
+ */
667
+ getEmulatorImages(
668
+ options?: Mobile.IListEmulatorsOptions
669
+ ): Promise<Mobile.IListEmulatorsOutput>;
670
+
671
+ /**
672
+ * Starts an emulator by provided options.
673
+ * @param options
674
+ * @returns {Promise<string[]>} - Returns array of errors.
675
+ */
676
+ startEmulator(options?: IStartEmulatorOptions): Promise<string[]>;
677
+
678
+ /**
679
+ * Returns a single device based on the specified options. If more than one devices are matching,
680
+ * prompts the user for a manual choice or returns the first one for non interactive terminals.
681
+ */
682
+ pickSingleDevice(
683
+ options: IPickSingleDeviceOptions
684
+ ): Promise<Mobile.IDevice>;
685
+
686
+ getPlatformsFromDeviceDescriptors(
687
+ deviceDescriptors: ILiveSyncDeviceDescriptor[]
688
+ ): string[];
689
+ }
690
+
691
+ interface IPickSingleDeviceOptions {
692
+ /**
693
+ * Pick from the connected emulators only
694
+ */
695
+ onlyEmulators: boolean;
696
+ /**
697
+ * Pick from the connected real devices only
698
+ */
699
+ onlyDevices: boolean;
700
+ /**
701
+ * Pick a specific device
702
+ */
703
+ deviceId: string;
704
+ }
705
+
706
+ interface IListEmulatorsOptions {
707
+ platform?: string;
708
+ }
709
+
710
+ interface IListEmulatorsOutput extends IDictionary<IEmulatorImagesOutput> {
711
+ ios: IEmulatorImagesOutput;
712
+ android: IEmulatorImagesOutput;
713
+ }
714
+
715
+ interface IEmulatorImagesOutput {
716
+ devices: Mobile.IDeviceInfo[];
717
+ errors: string[];
718
+ }
719
+
720
+ interface IPortForwardDataBase {
721
+ deviceIdentifier: string;
722
+ appIdentifier: string;
723
+ }
724
+
725
+ interface IPortForwardData extends IPortForwardDataBase {
726
+ abstractPort: string;
727
+ }
728
+
729
+ /**
730
+ * Describes methods for working with Android processes.
731
+ */
732
+ interface IAndroidProcessService {
733
+ /**
734
+ * Checks for available ports and forwards the current abstract port to one of the available ports.
735
+ * @param deviceIdentifier The identifier of the device.
736
+ * @param appIdentifier The identifier of the application.
737
+ * @param framework {string} The framework of the application. Could be Cordova or NativeScript.
738
+ * @return {string} Returns the tcp port number which is mapped to the abstract port.
739
+ */
740
+ mapAbstractToTcpPort(
741
+ deviceIdentifier: string,
742
+ appIdentifier: string,
743
+ framework: string
744
+ ): Promise<string>;
745
+
746
+ /**
747
+ * Gets the applications which are available for debugging on the specified device.
748
+ * @param deviceIdentifier The identifier of the device.
749
+ * @return {Mobile.IDeviceApplicationInformation[]} Returns array of applications information for the applications which are available for debugging.
750
+ */
751
+ getDebuggableApps(
752
+ deviceIdentifier: string
753
+ ): Promise<Mobile.IDeviceApplicationInformation[]>;
754
+
755
+ /**
756
+ * Gets all mapped abstract to tcp ports for specified device id and application identifiers.
757
+ * @param deviceIdentifier {string} The identifier of the device.
758
+ * @param appIdentifiers {string[]} Application identifiers that will be checked.
759
+ * @param framework {string} The framework of the application. Could be Cordova or NativeScript.
760
+ * @return {Promise<IDictionary<number>>} Dictionary, where the keys are app identifiers and the values are local ports.
761
+ */
762
+ getMappedAbstractToTcpPorts(
763
+ deviceIdentifier: string,
764
+ appIdentifiers: string[],
765
+ framework: string
766
+ ): Promise<IDictionary<number>>;
767
+
768
+ /**
769
+ * Gets the PID of a running application.
770
+ * @param deviceIdentifier {string} The identifier of the device.
771
+ * @param appIdentifier The identifier of the application.
772
+ * @return {string} Returns the process id matching the application identifier in the device process list.
773
+ */
774
+ getAppProcessId(
775
+ deviceIdentifier: string,
776
+ appIdentifier: string
777
+ ): Promise<string>;
778
+
779
+ /**
780
+ * Sets port forwarding to a specified abstract port.
781
+ * First checks if there's already existing port forwarding and if yes, takes the TCP port from there and returns it to the result.
782
+ * In case there's no port forwarding, gets a free TCP port and executes adb forward.
783
+ * @param {IPortForwardData} portForwardInputData Data describing required information to setup port forwarding.
784
+ * @returns {number} The TCP port that is used for the forwarding.
785
+ */
786
+ forwardFreeTcpToAbstractPort(
787
+ portForwardInputData: IPortForwardData
788
+ ): Promise<number>;
789
+ }
790
+
791
+ /**
792
+ * Describes information for WebView that can be debugged.
793
+ */
794
+ interface IDebugWebViewInfo {
795
+ /**
796
+ * Short description of the view.
797
+ */
798
+ description: string;
799
+
800
+ /**
801
+ * Url to the devtools.
802
+ * @example http://chrome-devtools-frontend.appspot.com/serve_rev/@211d45a5b74b06d12bb016f3c4d54095faf2646f/inspector.html?ws=127.0.0.1:53213/devtools/page/4024
803
+ */
804
+ devtoolsFrontendUrl: string;
805
+
806
+ /**
807
+ * Unique identifier of the web view. Could be number or GUID.
808
+ * @example 4027
809
+ */
810
+ id: string;
811
+
812
+ /**
813
+ * Title of the WebView.
814
+ * @example https://bit.ly/12345V is not available
815
+ */
816
+ title: string;
817
+
818
+ /**
819
+ * Type of the WebView.
820
+ * @example page
821
+ */
822
+ type: string;
823
+
824
+ /**
825
+ * URL loaded in the view.
826
+ * @example https://bit.ly/12345V
827
+ */
828
+ url: string;
829
+
830
+ /**
831
+ * Debugger URL.
832
+ * @example ws://127.0.0.1:53213/devtools/page/4027
833
+ */
834
+ webSocketDebuggerUrl: string;
835
+ }
836
+
837
+ interface ILocalToDevicePathData {
838
+ getLocalPath(): string;
839
+ getDevicePath(): string;
840
+ getRelativeToProjectBasePath(): string;
841
+ deviceProjectRootPath: string;
842
+ }
843
+
844
+ interface ILocalToDevicePathDataFactory {
845
+ create(
846
+ fileName: string,
847
+ localProjectRootPath: string,
848
+ onDeviceFileName: string,
849
+ deviceProjectRootPath: string
850
+ ): Mobile.ILocalToDevicePathData;
851
+ }
852
+
853
+ interface IAvdInfo extends IDictionary<string | number> {
854
+ target: string;
855
+ targetNum: number;
856
+ path: string;
857
+ device?: string;
858
+ displayName?: string;
859
+ avdId?: string;
860
+ name?: string;
861
+ abi?: string;
862
+ skin?: string;
863
+ sdcard?: string;
864
+ }
865
+
866
+ interface IAvdManagerDeviceInfo extends IStringDictionary {
867
+ name: string;
868
+ device: string;
869
+ path: string;
870
+ target: string;
871
+ skin: string;
872
+ sdcard: string;
873
+ }
874
+
875
+ interface IEmulatorPlatformService {
876
+ /**
877
+ * Gets all available emulators
878
+ * @returns {Promise<Mobile.IEmulatorImagesOutput>}
879
+ */
880
+ getEmulatorImages(): Promise<Mobile.IEmulatorImagesOutput>;
881
+ /**
882
+ * Gets the ids of all running emulators
883
+ * @returns {Promise<string[]>}
884
+ */
885
+ getRunningEmulatorIds(): Promise<string[]>;
886
+ /**
887
+ * Gets the name of the running emulator.
888
+ * @param emulatorId - The identifier of the running emulator.
889
+ * @returns {Promise<string>} - The name of the running emulator.
890
+ */
891
+ getRunningEmulatorName(emulatorId: string): Promise<string>;
892
+ /**
893
+ * Gets the emulator image identifier of a running emulator specified by emulatorId parameter.
894
+ * @param emulatorId - The identifier of the running emulator.
895
+ * @returns {Promise<string>} - The image identifier ot the running emulator.
896
+ */
897
+ getRunningEmulatorImageIdentifier(emulatorId: string): Promise<string>;
898
+ /**
899
+ * Starts the emulator by provided options.
900
+ * @param options
901
+ * @returns {Promise<IStartEmulatorOutput>} Starts the emulator and returns the errors if some error occurs.
902
+ */
903
+ startEmulator(
904
+ options: Mobile.IStartEmulatorOptions
905
+ ): Promise<IStartEmulatorOutput>;
906
+
907
+ /**
908
+ * Called when emulator is lost. Its purpose is to clean any resources used by the instance.
909
+ * @returns {void}
910
+ */
911
+ detach?(deviceInfo: Mobile.IDeviceInfo): void;
912
+ }
913
+
914
+ interface IStartEmulatorOutput {
915
+ errors: string[];
916
+ }
917
+
918
+ interface IAndroidVirtualDeviceService {
919
+ /**
920
+ * Gets all available emulators.
921
+ * @returns {Promise<Mobile.IEmulatorImagesOutput>} - Dictionary in the following format: { devices: Mobile.IDevice[], errors: string[] }.
922
+ * Returns array of all available android emulators - genymotion and native avd emulators and array of errors.
923
+ */
924
+ getEmulatorImages(
925
+ adbDevicesOutput: string[]
926
+ ): Promise<Mobile.IEmulatorImagesOutput>;
927
+ /**
928
+ * Gets all identifiers of all running android emulators.
929
+ * @param adbDevicesOutput The output from "adb devices" command
930
+ * @returns {Promise<string[]>} - Array of ids of all running emulators.
931
+ */
932
+ getRunningEmulatorIds(adbDevicesOutput: string[]): Promise<string[]>;
933
+ /**
934
+ * Gets the name of the running emulator specified by emulatorId parameter.
935
+ * @param emulatorId - The identifier of the running emulator.
936
+ * @returns {Promise<string>} - The name of the running emulator.
937
+ */
938
+ getRunningEmulatorName(emulatorId: string): Promise<string>;
939
+ /**
940
+ * Gets the image identifier of the running emulator specified by emulatorId parameter.
941
+ * @param emulatorId - The identifier of the running emulator.
942
+ * @returns {Promise<string>} - The image identifier of the running emulator.
943
+ */
944
+ getRunningEmulatorImageIdentifier(emulatorId: string): Promise<string>;
945
+ /**
946
+ * Gets the path to emulator executable. It will be passed to spawn when starting the emulator.
947
+ * For genymotion emulators - the path to player.
948
+ * For avd emulators - the path to emulator executable.
949
+ */
950
+ pathToEmulatorExecutable: string;
951
+ /**
952
+ * Gets the arguments that will be passed to spawn when starting the emulator.
953
+ * @param imageIdentifier - The imagerIdentifier of the emulator.
954
+ */
955
+ startEmulatorArgs(imageIdentifier: string): string[];
956
+ /**
957
+ * Called when emulator is lost. Its purpose is to clean any resources used by the instance.
958
+ * @returns {void}
959
+ */
960
+ detach?(deviceInfo: Mobile.IDeviceInfo): void;
961
+ }
962
+
963
+ interface IVirtualBoxService {
964
+ /**
965
+ * Lists all virtual machines.
966
+ * @returns {Promise<IVirtualBoxListVmsOutput>} - Returns a dictionary in the following format: { vms: IVirtualBoxVm[]; error?: string; }
967
+ * where vms is an array of name and id for each virtual machine.
968
+ */
969
+ listVms(): Promise<IVirtualBoxListVmsOutput>;
970
+ /**
971
+ * Gets all propertier for the specified virtual machine.
972
+ * @param id - The identifier of the virtual machine.
973
+ * @returns {Promise<IVirtualBoxEnumerateGuestPropertiesOutput>} - Returns a dictionary in the following format: { properties: string; error?: string; }
974
+ */
975
+ enumerateGuestProperties(
976
+ id: string
977
+ ): Promise<IVirtualBoxEnumerateGuestPropertiesOutput>;
978
+ }
979
+
980
+ interface IVirtualBoxListVmsOutput {
981
+ /**
982
+ * List of virtual machines
983
+ */
984
+ vms: IVirtualBoxVm[];
985
+ /**
986
+ * The error if something is not configured properly.
987
+ */
988
+ error?: string;
989
+ }
990
+
991
+ interface IVirtualBoxEnumerateGuestPropertiesOutput {
992
+ /**
993
+ * The output of `vboxmanage enumerate guestproperty <id>` command
994
+ */
995
+ properties: string;
996
+ /**
997
+ * The error if something is not configured properly.
998
+ */
999
+ error?: string;
1000
+ }
1001
+
1002
+ interface IVirtualBoxVm {
1003
+ /**
1004
+ * The id of the virtual machine.
1005
+ */
1006
+ id: string;
1007
+ /**
1008
+ * The name of the virtual machine.
1009
+ */
1010
+ name: string;
1011
+ }
1012
+
1013
+ interface IAndroidIniFileParser {
1014
+ /**
1015
+ * Returns avdInfo from provided .ini file.
1016
+ * @param iniFilePath - The full path to .ini file.
1017
+ * @param avdInfo - avdInfo from previously parsed .ini file in case there are such.
1018
+ */
1019
+ parseIniFile(
1020
+ iniFilePath: string,
1021
+ avdInfo?: Mobile.IAvdInfo
1022
+ ): Mobile.IAvdInfo;
1023
+ }
1024
+
1025
+ interface IiSimDevice {
1026
+ /**
1027
+ * The name of the simulator. For example: 'iPhone 4s', 'iPad Retina'
1028
+ */
1029
+ name: string;
1030
+ /**
1031
+ * The unique identifier of the simulator. For example: 'B2FD3FD3-5982-4B56-A7E8-285DBC74ECCB', '49AFB795-8B1B-4CD1-8399-690A1A9BC00D'
1032
+ */
1033
+ id: string;
1034
+ /**
1035
+ * The full identifier of the simulator. For example: 'com.apple.CoreSimulator.SimDeviceType.iPhone 5s', 'com.apple.CoreSimulator.SimDeviceType.iPad Retina'
1036
+ */
1037
+ fullId: string;
1038
+ /**
1039
+ * The sdk version of the simulator. For example: '8.4', '9.3', '11.3'
1040
+ */
1041
+ runtimeVersion: string;
1042
+ /**
1043
+ * The state of the simulator. Can be 'Shutdown' or 'Booted'
1044
+ */
1045
+ state?: string;
1046
+ /**
1047
+ * The platform of the device (iOS, visionOS)
1048
+ */
1049
+ platform?: string;
1050
+ }
1051
+
1052
+ interface IiOSSimResolver {
1053
+ iOSSim: IiOSSim;
1054
+ iOSSimPath: string;
1055
+ }
1056
+
1057
+ interface IiOSSim {
1058
+ getApplicationPath(deviceId: string, appIdentifier: string): string;
1059
+ getDeviceLogProcess(deviceId: string, options?: any): any;
1060
+ getDevices(): Promise<Mobile.IiSimDevice[]>;
1061
+ getRunningSimulators(): Promise<IiSimDevice[]>;
1062
+ launchApplication(
1063
+ applicationPath: string,
1064
+ appIdentifier: string,
1065
+ options: IiOSSimLaunchApplicationOptions
1066
+ ): Promise<any>;
1067
+ printDeviceTypes(): Promise<any>;
1068
+ sendNotification(notification: string, deviceId: string): Promise<void>;
1069
+ startSimulator(data: IiOSSimStartSimulatorInput): Promise<string>;
1070
+ }
1071
+
1072
+ interface IiOSSimStartSimulatorInput {
1073
+ /**
1074
+ * The name or identifier of device that will be started.
1075
+ */
1076
+ device: string;
1077
+ /**
1078
+ * The sdk version of the device that will be started.
1079
+ */
1080
+ sdkVersion: string;
1081
+ state?: string;
1082
+ }
1083
+
1084
+ interface IiOSSimLaunchApplicationOptions {
1085
+ timeout: string;
1086
+ sdkVersion: string;
1087
+ device: string;
1088
+ args: string[];
1089
+ waitForDebugger: boolean;
1090
+ skipInstall: boolean;
1091
+ }
1092
+
1093
+ /**
1094
+ * Describes the information when trying to connect to port.
1095
+ */
1096
+ interface IConnectToPortData {
1097
+ /**
1098
+ * The port to connect.
1099
+ * @type {number}
1100
+ */
1101
+ port: number;
1102
+
1103
+ /**
1104
+ * Timeout in milliseconds.
1105
+ * @type {number}
1106
+ */
1107
+ timeout?: number;
1108
+ }
1109
+
1110
+ interface IiOSSimulatorService extends IEmulatorPlatformService {
1111
+ postDarwinNotification(
1112
+ notification: string,
1113
+ deviceId: string
1114
+ ): Promise<void>;
1115
+
1116
+ /**
1117
+ * Tries to connect to specified port for speciefied amount of time.
1118
+ * In case it succeeds, a socket is returned.
1119
+ * In case it fails, undefined is returned.
1120
+ * @param {IConnectToPortData} connectToPortData Data describing port and timeout to try to connect.
1121
+ * @returns {net.Socket} Returns instance of net.Socket when connection is successful, otherwise undefined is returned.
1122
+ */
1123
+ connectToPort(connectToPortData: IConnectToPortData): Promise<any>;
1124
+ }
1125
+
1126
+ interface IRunApplicationOnEmulatorOptions {
1127
+ /**
1128
+ * The identifier of the application that will be started on device.
1129
+ */
1130
+ appId?: string;
1131
+ /**
1132
+ * The args that will be passed to the application.
1133
+ */
1134
+ args?: string;
1135
+ /**
1136
+ * The device identifier.
1137
+ */
1138
+ device?: string;
1139
+ /**
1140
+ * If provided, redirect the application's standard output to a file.
1141
+ */
1142
+ stderrFilePath?: string;
1143
+ /**
1144
+ * If provided, redirect the applications's standard error to a file.
1145
+ */
1146
+ stdoutFilePath?: string;
1147
+ /**
1148
+ * If provided, only run the app on device (will skip app installation).
1149
+ */
1150
+ skipInstall?: boolean;
1151
+ /**
1152
+ * If provided, wait for debugger to attach.
1153
+ */
1154
+ waitForDebugger?: boolean;
1155
+ captureStdin?: boolean;
1156
+
1157
+ /**
1158
+ * If provided, print all available devices
1159
+ */
1160
+ availableDevices?: boolean;
1161
+
1162
+ timeout?: string;
1163
+ /**
1164
+ * The sdk version of the emulator.
1165
+ */
1166
+ sdk?: string;
1167
+
1168
+ justlaunch?: boolean;
1169
+ }
1170
+
1171
+ interface IStartEmulatorOptions {
1172
+ /**
1173
+ * The emulator's image identifier.
1174
+ */
1175
+ imageIdentifier?: string;
1176
+ /**
1177
+ * The identifier or name of the emulator.
1178
+ */
1179
+ emulatorIdOrName?: string;
1180
+ /**
1181
+ * The platform of the emulator.
1182
+ */
1183
+ platform?: string;
1184
+ /**
1185
+ * The sdk version of the emulator. Currently available only for iOS emulators.
1186
+ */
1187
+ sdk?: string;
1188
+ /**
1189
+ * The info about the emulator.
1190
+ */
1191
+ emulator?: Mobile.IDeviceInfo;
1192
+ }
1193
+
1194
+ interface IAndroidStartEmulatorOptions extends IStartEmulatorOptions {
1195
+ /**
1196
+ * The timeout in miliseconds what will be passed to android emulator. If 0 - will await infinity to start the emulator.
1197
+ */
1198
+ timeout?: number;
1199
+ }
1200
+
1201
+ interface IMobileHelper {
1202
+ platformNames: string[];
1203
+ isAndroidPlatform(platform: string): boolean;
1204
+ isiOSPlatform(platform: string): boolean;
1205
+ isvisionOSPlatform(platform: string): boolean;
1206
+ isApplePlatform(platform: string): boolean;
1207
+ normalizePlatformName(platform: string): string;
1208
+ validatePlatformName(platform: string): string;
1209
+ buildDevicePath(...args: string[]): string;
1210
+ correctDevicePath(filePath: string): string;
1211
+ isiOSTablet(deviceName: string): boolean;
1212
+ getDeviceFileContent(
1213
+ device: Mobile.IDevice,
1214
+ deviceFilePath: string,
1215
+ projectData: IProjectData
1216
+ ): Promise<string>;
1217
+ }
1218
+
1219
+ interface IEmulatorHelper {
1220
+ mapAndroidApiLevelToVersion: IStringDictionary;
1221
+ getEmulatorsFromAvailableEmulatorsOutput(
1222
+ availableEmulatorsOutput: Mobile.IListEmulatorsOutput
1223
+ ): Mobile.IDeviceInfo[];
1224
+ getErrorsFromAvailableEmulatorsOutput(
1225
+ availableEmulatorsOutput: Mobile.IListEmulatorsOutput
1226
+ ): string[];
1227
+ getEmulatorByImageIdentifier(
1228
+ imageIdentifier: string,
1229
+ emulators: Mobile.IDeviceInfo[]
1230
+ ): Mobile.IDeviceInfo;
1231
+ getEmulatorByIdOrName(
1232
+ emulatorIdOrName: string,
1233
+ emulators: Mobile.IDeviceInfo[]
1234
+ ): Mobile.IDeviceInfo;
1235
+ getEmulatorByStartEmulatorOptions(
1236
+ options: Mobile.IStartEmulatorOptions,
1237
+ emulators: Mobile.IDeviceInfo[]
1238
+ ): Mobile.IDeviceInfo;
1239
+ isEmulatorRunning(emulator: Mobile.IDeviceInfo): boolean;
1240
+ setRunningAndroidEmulatorProperties(
1241
+ emulatorId: string,
1242
+ emulator: Mobile.IDeviceInfo
1243
+ ): void;
1244
+ }
1245
+
1246
+ interface IDevicePlatformsConstants {
1247
+ iOS: string;
1248
+ Android: string;
1249
+ visionOS: string;
1250
+
1251
+ isiOS(value: string): boolean;
1252
+ isAndroid(value: string): boolean;
1253
+ isvisionOS(value: string): boolean;
1254
+ }
1255
+
1256
+ interface IDeviceApplication {
1257
+ CFBundleExecutable: string;
1258
+ Path: string;
1259
+ }
1260
+
1261
+ interface IiOSDeviceProductNameMapper {
1262
+ resolveProductName(deviceType: string): string;
1263
+ }
1264
+
1265
+ interface IHasDetectionInterval {
1266
+ detectionInterval?: number;
1267
+ }
1268
+
1269
+ interface IDeviceLookingOptions
1270
+ extends IHasEmulatorOption,
1271
+ IHasDetectionInterval {
1272
+ shouldReturnImmediateResult: boolean;
1273
+ platform: string;
1274
+ fullDiscovery?: boolean;
1275
+ }
1276
+
1277
+ interface IAndroidDeviceHashService {
1278
+ /**
1279
+ * Returns the hash file path on device
1280
+ */
1281
+ hashFileDevicePath: string;
1282
+ /**
1283
+ * If hash file exists on device, read the hashes from the file and returns them as array
1284
+ * If hash file doesn't exist on device, returns null
1285
+ */
1286
+ getShasumsFromDevice(): Promise<IStringDictionary>;
1287
+ /**
1288
+ * Uploads updated shasums to hash file on device
1289
+ */
1290
+ uploadHashFileToDevice(data: IStringDictionary): Promise<void>;
1291
+ /**
1292
+ * Computes the shasums of localToDevicePaths and updates hash file on device
1293
+ */
1294
+ updateHashes(
1295
+ localToDevicePaths: Mobile.ILocalToDevicePathData[]
1296
+ ): Promise<void>;
1297
+ /**
1298
+ * Computes the shasums of localToDevicePaths and removes them from hash file on device
1299
+ */
1300
+ removeHashes(
1301
+ localToDevicePaths: Mobile.ILocalToDevicePathData[]
1302
+ ): Promise<boolean>;
1303
+
1304
+ /**
1305
+ * Detects if there's hash file on the device for the specified device.
1306
+ * @return {Promise<boolean>} boolean True if file exists and false otherwise.
1307
+ */
1308
+ doesShasumFileExistsOnDevice(): Promise<boolean>;
1309
+
1310
+ /**
1311
+ * Generates hashes of specified localToDevicePaths by chunks and persists them in the passed @shasums argument.
1312
+ * @param {Mobile.ILocalToDevicePathData[]} localToDevicePaths The localToDevicePaths objects for which the hashes should be generated.
1313
+ * @param {IStringDicitionary} shasums Object in which the shasums will be persisted.
1314
+ * @returns {Promise<IStringDictionary>} The generated/updated shasums.
1315
+ */
1316
+ generateHashesFromLocalToDevicePaths(
1317
+ localToDevicePaths: Mobile.ILocalToDevicePathData[],
1318
+ initialShasums?: IStringDictionary
1319
+ ): Promise<IStringDictionary>;
1320
+
1321
+ /**
1322
+ * Generates DevicePaths of all elements from the input localToDevicePaths.
1323
+ * @param {Mobile.ILocalToDevicePathData[]} localToDevicePaths The localToDevicePaths objects for which the DevicePaths should be generated.
1324
+ * @returns {string[]} DevicePaths of all elements from the input localToDevicePaths.
1325
+ */
1326
+ getDevicePaths(
1327
+ localToDevicePaths: Mobile.ILocalToDevicePathData[]
1328
+ ): string[];
1329
+
1330
+ /**
1331
+ * Returns the changed shasums based on the provided
1332
+ * @param {IStringDictionary} oldShasums The old shasums on the device
1333
+ * @param {IStringDictionary} currentShasums The current shasums on the local project
1334
+ * @returns {string[]} Returns the shasums that changed
1335
+ */
1336
+ getChangedShasums(
1337
+ oldShasums: IStringDictionary,
1338
+ currentShasums: IStringDictionary
1339
+ ): IStringDictionary;
1340
+ }
1341
+
1342
+ /**
1343
+ * Describes information for Android debug bridge error.
1344
+ */
1345
+ interface IAndroidDebugBridgeError {
1346
+ /**
1347
+ * Name of the error.
1348
+ */
1349
+ name: string;
1350
+
1351
+ /**
1352
+ * Description of the error.
1353
+ */
1354
+ description: string;
1355
+
1356
+ /**
1357
+ * Returned result code.
1358
+ */
1359
+ resultCode: number;
1360
+ }
1361
+
1362
+ /**
1363
+ * Describes logic for handling Android debug bridge result.
1364
+ */
1365
+ interface IAndroidDebugBridgeResultHandler {
1366
+ /**
1367
+ * Checks the Android debug bridge result for errors.
1368
+ * @param {string} adbResult The Android debug bridge result.
1369
+ * @return {string} The errors found in the Android debug bridge result.
1370
+ */
1371
+ checkForErrors(adbResult: any): IAndroidDebugBridgeError[];
1372
+
1373
+ /**
1374
+ * Handles the Android debug bridge result errors.
1375
+ * @param {IAndroidDebugBridgeError[]} errors The Android debug bridge result errors.
1376
+ * @return {void}.
1377
+ */
1378
+ handleErrors(
1379
+ errors: IAndroidDebugBridgeError[],
1380
+ treatErrorsAsWarnings?: boolean
1381
+ ): void;
1382
+ }
1383
+
1384
+ /**
1385
+ * Describes basic information about application on device.
1386
+ */
1387
+ interface IDeviceApplicationInformationBase extends IDeviceIdentifier {
1388
+ /**
1389
+ * The application identifier.
1390
+ */
1391
+ appIdentifier: string;
1392
+ }
1393
+
1394
+ /**
1395
+ * Describes information about application on device.
1396
+ */
1397
+ interface IDeviceApplicationInformation
1398
+ extends IDeviceApplicationInformationBase {
1399
+ /**
1400
+ * The framework of the project (Cordova or NativeScript).
1401
+ */
1402
+ framework: string;
1403
+ }
1404
+ }
1405
+
1406
+ interface IIOSDeviceOperations extends IDisposable, NodeJS.EventEmitter {
1407
+ install(
1408
+ ipaPath: string,
1409
+ deviceIdentifiers: string[],
1410
+ errorHandler?: DeviceOperationErrorHandler
1411
+ ): Promise<IOSDeviceResponse>;
1412
+
1413
+ uninstall(
1414
+ appIdentifier: string,
1415
+ deviceIdentifiers: string[],
1416
+ errorHandler?: DeviceOperationErrorHandler
1417
+ ): Promise<IOSDeviceResponse>;
1418
+
1419
+ startLookingForDevices(
1420
+ deviceFoundCallback: DeviceInfoCallback,
1421
+ deviceUpdatedCallback: DeviceInfoCallback,
1422
+ deviceLostCallback: DeviceInfoCallback,
1423
+ options?: Mobile.IDeviceLookingOptions
1424
+ ): Promise<void>;
1425
+
1426
+ startDeviceLog(deviceIdentifier: string): void;
1427
+
1428
+ apps(
1429
+ deviceIdentifiers: string[],
1430
+ errorHandler?: DeviceOperationErrorHandler
1431
+ ): Promise<IOSDeviceAppInfo>;
1432
+
1433
+ listDirectory(
1434
+ listArray: IOSDeviceLib.IReadOperationData[],
1435
+ errorHandler?: DeviceOperationErrorHandler
1436
+ ): Promise<IOSDeviceMultipleResponse>;
1437
+
1438
+ readFiles(
1439
+ deviceFilePaths: IOSDeviceLib.IReadOperationData[],
1440
+ errorHandler?: DeviceOperationErrorHandler
1441
+ ): Promise<IOSDeviceResponse>;
1442
+
1443
+ downloadFiles(
1444
+ deviceFilePaths: IOSDeviceLib.IFileOperationData[],
1445
+ errorHandler?: DeviceOperationErrorHandler
1446
+ ): Promise<IOSDeviceResponse>;
1447
+
1448
+ uploadFiles(
1449
+ files: IOSDeviceLib.IUploadFilesData[],
1450
+ errorHandler?: DeviceOperationErrorHandler
1451
+ ): Promise<IOSDeviceResponse>;
1452
+
1453
+ deleteFiles(
1454
+ deleteArray: IOSDeviceLib.IDeleteFileData[],
1455
+ errorHandler?: DeviceOperationErrorHandler
1456
+ ): Promise<IOSDeviceResponse>;
1457
+
1458
+ start(
1459
+ startArray: IOSDeviceLib.IIOSApplicationData[],
1460
+ errorHandler?: DeviceOperationErrorHandler
1461
+ ): Promise<IOSDeviceResponse>;
1462
+
1463
+ stop(
1464
+ stopArray: IOSDeviceLib.IIOSApplicationData[],
1465
+ errorHandler?: DeviceOperationErrorHandler
1466
+ ): Promise<IOSDeviceResponse>;
1467
+
1468
+ postNotification(
1469
+ postNotificationArray: IOSDeviceLib.IPostNotificationData[],
1470
+ errorHandler?: DeviceOperationErrorHandler
1471
+ ): Promise<IOSDeviceResponse>;
1472
+
1473
+ awaitNotificationResponse(
1474
+ awaitNotificationResponseArray: IOSDeviceLib.IAwaitNotificatioNResponseData[],
1475
+ errorHandler?: DeviceOperationErrorHandler
1476
+ ): Promise<IOSDeviceResponse>;
1477
+
1478
+ connectToPort(
1479
+ connectToPortArray: IOSDeviceLib.IConnectToPortData[],
1480
+ errorHandler?: DeviceOperationErrorHandler
1481
+ ): Promise<IDictionary<IOSDeviceLib.IConnectToPortResponse[]>>;
1482
+
1483
+ setShouldDispose(shouldDispose: boolean): void;
1484
+ }
1485
+
1486
+ type DeviceOperationErrorHandler = (err: IOSDeviceLib.IDeviceError) => void;
1487
+
1488
+ type DeviceInfoCallback = (
1489
+ deviceInfo: IOSDeviceLib.IDeviceActionInfo
1490
+ ) => void;
1491
+
1492
+ type IOSDeviceResponse = IDictionary<IOSDeviceLib.IDeviceResponse[]>;
1493
+
1494
+ type IOSDeviceMultipleResponse = IDictionary<
1495
+ IOSDeviceLib.IDeviceMultipleResponse[]
1496
+ >;
1497
+
1498
+ type IOSDeviceAppInfo = IDictionary<IOSDeviceLib.IDeviceAppInfo[]>;
1499
+ }