Ver código fonte

Document ios-deploy and ADB usage to install/launch bundled games

Vlad Protsenko 2 anos atrás
pai
commit
84fdad7d2d

+ 9 - 1
docs/en/manuals/android.md

@@ -58,7 +58,7 @@ Press <kbd>Create Bundle</kbd> when you have configured the application bundle s
 
 ### Installing an Android application bundle
 
-### Installing an APK
+#### Installing an APK
 
 An *.apk* file can be copied to your device with the `adb` tool, or to Google Play via the [Google Play developer console](https://play.google.com/apps/publish/).
 
@@ -71,6 +71,14 @@ $ adb install Defold\ examples.apk
 Success
 ```
 
+#### Installing an APK using editor
+
+You can install and launch an *.apk* file using the editor's "Install on connected device" and "Launch installed app" check-boxes in the Bundle dialog:
+
+![Install and Launch APK](images/android/install_and_launch.png)
+
+For this feature to work, you will need ADB installed and *USB debugging* enabled on the connected device. If the editor can't detect the install location of the ADB command line tool, you will need to specify it in [Preferences](/manuals/editor-preferences/#tools).
+
 #### Installing an AAB
 
 An *.aab* file can be uploaded to Google Play via the [Google Play developer console](https://play.google.com/apps/publish/). It is also possible to generate an *.apk* file from an *.aab* file to install it locally using the [Android bundletool](https://developer.android.com/studio/command-line/bundletool).

+ 10 - 0
docs/en/manuals/editor-preferences.md

@@ -57,3 +57,13 @@ Build Server
 
 Build Server Headers
 : additional headers to the build server when building native extensions. It's important for using CloudFlare service or similar services with extender.
+
+## Tools
+
+![](images/editor/preferences_tools.png){srcset="images/editor/[email protected] 2x"}
+
+ADB path
+: Path to [ADB](https://developer.android.com/tools/adb) command line tool installed on this system. If you have ADB installed on your system, the Defold editor will use it to install and run bundled Android APKs to a connected Android Device. By default, the editor checks if ADB is installed in well-known locations, so you only need to specify the path if you have ADB installed in a custom location.
+
+ios-deploy path
+: Path to [ios-deploy](https://github.com/ios-control/ios-deploy) command line tools installed on this system (only relevant for macOS). Similarly to the ADB path, the Defold editor will use this tool to install and run bundled iOS applications on a connected iPhone. By default, the editor checks if ios-deploy is installed in well-known locations, so you only need to specify the path if you use a custom installation of os-deploy.

BIN
docs/en/manuals/images/android/install_and_launch.png


BIN
docs/en/manuals/images/editor/preferences_tools.png


BIN
docs/en/manuals/images/editor/[email protected]


BIN
docs/en/manuals/images/ios/install_and_launch.png


+ 13 - 0
docs/en/manuals/ios.md

@@ -103,6 +103,19 @@ Press *Create Bundle* and you will then be prompted to specify where on your com
 
 You specify what icon to use for the app, the launch screen storyboard and so forth in the *game.project* project settings file in the [iOS section](/manuals/project-settings/#ios).
 
+## Installing and launching bundle on a connected iPhone
+
+You can install and launch the built bundle using editor's "Install on connected device" and "Launch installed app" check-boxes in the Bundle dialog:
+
+![Install and launch iOS bundle](images/ios/install_and_launch.png)
+
+You need [ios-deploy](https://github.com/ios-control/ios-deploy) command lint tool installed for this feature to work. The simplest way to install it is using Homebrew:
+```
+$ brew install ios-deploy
+```
+
+If the editor can't detect the install location of the ios-deploy tool, you will need to specify it in [Preferences](/manuals/editor-preferences/#tools). 
+
 ### Creating a storyboard
 
 You create a storyboard file using Xcode. Start Xcode and create a new project. Select iOS and Single View App: