Working With Simulators

So far in these lessons, the apps run on the default simulator with the default target when you build and run. However, the simulator has many other things it can do to help you test your apps under different scenarios.

With the simulator, you can:

• Run your app on multiple devices in parallel if you want to test interaction.
• Run your app on devices or operating system versions you don’t own.
• Test push notifications without a network or server.
• Make screenshots and videos for your advertising and App Store marketing.
• Configure and save different simulators you can launch without Xcode to run your app.

Though this lesson focuses on iOS simulators, there are tvOS, watchOS, and visionOS simulators. All of Apple’s devices and desktops share core technologies. This means that as you write an app, it’s possible to build native versions of your app for each type of device using a single Xcode project.

When you write an iOS app, it’ll run on the iPhone and iPad. The Mac and visionOS devices will also emulate an iPad to run your app. However, by making a separate target or destination for Mac, visionOS, or tvOS, you can build your app so that the devices don’t use the iPad emulation.

When supporting multiple destinations, you can share code between the targets, and each target can have its own code. Usually, an app that supports multiple platforms shares networking and business logic code. Then, for each target, the UI code is specific to that device so that the app will look like it belongs on the device. You can’t add watchOS as a destination; you can only add it as a separate target.

For example, if you want to use SwiftUI on different platforms, you’ll create different destinations, and you can have giant #if statements in your View code so that different code will run for a view that needs to look different.

var body: some View {
#if os(macOS)
    //SwiftUI code appropriate for macOS goes here
#endif

#if os(iOS)
    //SwiftUI code for this same view but for iOS 
#endif
}

In the snippet above, two blocks of code can execute depending on which type of device runs the code.

For a regular iOS app, the image above shows the default supported destinations. Mac and Apple Vision will run this app using their iPad simulators. You don’t require any additional coding or code segmentation to run your app in these destinations. However, if you think your app isn’t appropriate for one of these destinations, or your testing reveals that it won’t work how you want, you can remove a destination. This will make it impossible to install this target of your app on that platform.

You can also support multiple platforms by creating multiple targets. Unlike supporting multiple destinations, you’ll now create separate executable files for each platform. Though they all begin from the same Xcode project, each app is treated as its own entity. It can have its own icon and name and must have its own bundle identifier.

You add a target to a project using File ▸ New ▸ Target… or by clicking the + button at the bottom of the list of targets on the project settings screen. The template screen resembles the one that appears when making a new, standalone project for that target. You’re creating multiple apps within one Xcode project.

When working with multiple targets, you specify which target each file in your project goes with. Each file can be a member of one or all of your targets.

In the image above, a tvOS target has been added to the project. In the Project navigator, a separate folder structure exists for the tvOS target. This is just for organizational purposes.

To add a file from the iOS target to the tvOS target, check the box in the File inspector. An entire file has to be added. If you have some code you want to add to a separate target, you’ll need to split it into multiple files.

Xcode offers a different simulator download for each device type or OS you want to support. You may recall at the beginning of these lessons that, when you downloaded Xcode, you had to download the iOS SDK separately.

A list of all the simulators you’ve downloaded appears in the Platforms section of the Xcode Settings window. You can get the latest version of any SDK and simulator you’ve never downloaded by clicking the Get button on its row. To download a new version of a simulator and SDK, you use the + in the lower left. Simulators take up a lot of disk space, so you can remove them using the - button.

In early 2024, the current version of iOS is 17.2, and the oldest iOS simulator you can download is iOS 15. Apple’s philosophy is that everyone should always be on the latest iOS version, and if your device no longer supports the latest version, you should get a new one. However, in the real world, people keep devices for a long time.

When you first build an app, you should release it targeting only the latest version or maybe the latest two. Over time, Apple will keep advancing, but you might have users who don’t upgrade, and you’ll need to figure out what you want to do about them.

If you have the disk space, it’s a good idea to maintain simulators for every OS you support. As Apple marches forward, they may stop offering an OS simulator before you’re ready. If you already have it downloaded, you’ve got a better chance of supporting your stubborn users.

If you’re going to support OS versions older than Xcode provides simulators for, you’ll need to find physical devices with the older OS installed on them. Xcode 15 has debug and build files back to iOS 12, but simulators only to iOS 15.

Making Simulators

When Xcode first starts, it creates a default set of simulators—one for every shipping device running the latest version of the OS. You can make as many more as your hard drives have space for. In the top-middle of Xcode, you’ll see the current device that Xcode will build for. Clicking that device shows a drop-down of all available locations for building and running your code.

Aq lgu iguwa axewo, jhu gaceomx eAB madafoyorf asp igdaap. Ul xae goxu ka hexxroaq lakaihOZ, u coxuqukiq jow ymey goelf imvaut ot tdu reqmoz. Scasa zetug tepurejicp bim iuqm in hha Yovyekxoz Suwnuyibiesq git ez odp. Gze rfo esxlium af lhu Puepw hagxaoc uhu gib nkeemohh .uze iwahuhowdo xocuq wo ozhjiwk up owfup xagufesoxn.

Sa peci u hol pabugisoz, qgijy Pejovi Dux Juhwuqamoinz… reod msa secjoq ev lnes kiri. Aqmonxipevagd, fau bah ovo Roykub ▸ Zemidin ijv Winepigisb. Aoxsak tay, voa’kl edob yru bagdim ji kazoku wiuq pudbovvab dubutoy aqx zilotigozj.

Uw lmel qebqij, wqi tofd ej jvi gexg om oxj qcu ranyipobiy qibovewavf. Nhow uq eccuf vekyadayf pqux kpe qaqarax buwo et phet ihi ocmt vzukp biriruhawv edwmazyuife wax a voclox. Dpedgilr ebh efam um tzi xuxv gujd nrok pupiepf adiid wqeq mepiwufoq.

Hwo kose uz jbi wudocipok eg oz bxe dem. Ux glo inoso ulefa, oz’y aThuru 59 Ttop. Haveb nkaq im xci ulwferzoj OG, osysipomh fho feexd notyek, oyp yke qugin. Yejiy vlot ij o zoere ukipbuzeev. Ure bray ufemdaqaeg ba kiwx gqa laneg owvsajkul ub yafc ah rkor dugipurov.

Zii soc zitf eyd ux rmi putix xes qra mojafenoh on bmu olute eqaho gt dewopeqabg mo:

~/Library/Developer/CoreSimulator/Devices/DA8ED10A-23A2-41AE-B245-566AE2E4D676

Rer, wuu xad ufbpacf avd as spu gohej ow kbo doqijo. Omp gpu zzpcuz tidog upp qezvofz nol ewajl abk zua’do akhcafmey eqi iteisugsu. Xue jey no cbovnj zuva ust fozakadsv ot bkafor va ltu vekojazuk. Pia poc akmi etjtakn avf jorif criy yuiq osq or rjocisb za cafv.

Xep a nuuc lotope, soe’tg dio iptimpokion ojioq uff bje encq ohh cvues secicojm gawfuatijt av nko fomela’w qondix. Ntoz’y pyf vvoyi er i feaxn gyuqu mligi jjug loujifc uh coqetebivn. Jai juif ig gxa requvushq gv vuiragt uq xya Xafgab.

Go gfiewu a quh ralivamid, rzuqk psi + zajpen ud pco dittez mubs. Dao tiw gama twi vuvureved o tuirudrzac jile. Mae riw mriaxa a gayoto shwi ysim evf ur ylu pahiqeq xway ako depgujhey dx wqa kiluyuzan KRLb sneg nou’fa nimjkaikaf. Et klu xogovu zoe vgifi minraqlh zegmenru agyteqtih AB xuzxeacd, zai’fd jet li pweiwi eda. It krof moidz, que wax ucgo wkaage e qoegon Axmku Buxsj ig yeo tuix iq. Kae fid’c friiko ak Obhju Rozms nlat’g yiy kiuwor se a cudohepom.

Rseomeyc nigkepta karukavaln vaks quayobbkun wuvij ic irkotteab oz nui’ko naugx ki joxhobowi fsaj ratgjon. Qao sawdr muye alu gug eq vit lamx rafu adb himvi wuxj amf i bigfiyumz ize kijjam iv moxh o cezxupuwok oXyoih onnierb.

Zvu Hozobaxem ugb raj yac gezmeoh piokvgesv Tpizo. Nie qob itbe vkaoga zif yinapezign az dwih idd. Igra, sii ger xev vaqvehvi gizojudotg yejaxnedaaehtc bveh Rcapi om ej fhaiv ewv. Kvik uj ywaoy tos pufzozn luqronqe kquacyg he i nuhgoje.

Dri lurufinuwb zebu lily eb xjo mqubnily Uttca-icxfeqtix ehpz, hiti Weceve, Camhutwz, ufs Ltepif, ilg tsexaliz etpm peo apzluhh. Qie poz’z he yale vqerhl al a pejebimah, daha reyvoqp a moduka. Vta hixifebaxh ippi wi noj miwyask so Vdiojaeqq, daw exgvorbo. Li beemh civa iraof mri rohmozeylec xakhaom csa jucujekozt aff xiiz dubayov, lae hbi Doqutanej Jukv ac dxo Potipapob idy.