Skip to content

Commit 27340c9

Browse files
committed
ios: improvements to lime test ios instructions
Some things that may need to be done before the command will work.
1 parent e4fb350 commit 27340c9

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

_docs/advanced-setup/ios.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,16 @@ Before you can build for a device, you will also need to connect your device to
2222

2323
To compile an iOS or iPadOS application bundle, run `lime build ios`. Add the `-debug` option to create a debug build. Add the `-release` option to create a release build.
2424

25-
To compile and launch an iOS application with one command, run `lime test ios`. The app will run on a device connected to your computer with USB. Add the `-simulator` option to target the iOS simulator included with Xcode instead of a device.
25+
To compile and launch an application on a physical iOS device connected to your computer with USB, run `lime test ios`.
2626

27-
> _Note:_ The first time that you compile a project for C++, it will take a noticably long time. However, compiling the same project again should be significantly faster because parts of your code that have not changed do not need to be recompiled. To force all of code to be recompiled for C++, use the `-clean` option.
27+
> _Note:_ You may need to unlock the connected iOS device before you can install an app. If your iOS device asks, you may also need to tell it that you trust your computer. With some Lime versions, you may also need to launch Xcode on your computer before it will detect your connected iOS device.
28+
29+
If you prefer to test in a simulator instead, run `lime test ios -simulator` to target the iOS simulator included with Xcode instead of a physical device.
2830

2931
Specify the `-appstore` option to create a build to be submitted to the iOS App Store. Alternatively, specify the `-adhoc` option for ad hoc distribution to specific devices outside of the App Store. For enterprise distribution within your organization, specify the `-enterprise` option.
3032

33+
> _Note:_ The first time that you compile a project for C++, it will take a noticably long time. However, compiling the same project again should be significantly faster because parts of your code that have not changed do not need to be recompiled. To force all of code to be recompiled for C++, use the `-clean` option.
34+
3135
## Advanced Configuration
3236

3337
The `<config:ios />` element in your [_project.xml_](../../project-files/xml-format/) file is used to specify advanced configuration options for iOS. A few of the more commonly-used advanced configuration options for iOS are documented below. For more details about the available advanced options, see [Config Values: iOS](../../project-files/xml-format/config/#ios).

0 commit comments

Comments
 (0)