CODEWITHSUNDEEP
iosxcodeios-simulatorui-testingfastlane-snapshot
Clafou
Clafou

Reputation: 15400

How to test Dynamic Type (larger font sizes) in iOS Simulator

Changing Dynamic Type settings in iOS can be done manually (Settings > General > Accessibility > Larger Text).

But this does not appear to work in the current Simulator (v9.3 at the time of writing), and doing so manually is not a solution where automation is required.

Question: Is there a way to launch an app with Dynamic Type settings to launch an app with larger font sizes?

Note: This is not only useful for UI testing, but also for the purpose of creating screenshots using Fastlane Snapshot with larger font sizes.

Upvotes: 12

Views: 7014

Answers (5)

bjtitus
bjtitus

Reputation: 4270

As of Xcode 8, there is a better option than the undocumented launch arguments: Accessibility Inspector. It is covered in this talk and can be found under Xcode > Open Developer Tool.

Update for Xcode 11+

There is a new Environment Overrides option. Find more information in this answer.

Xcode Accessibility Inspector

Upvotes: 11

keehun
keehun

Reputation: 41

It is actually possible to overwrite the content category size at the application-level which is especially useful for unit and UI tests.

Check it out here: https://medium.com/livefront/practical-dynamic-type-part-2-testing-613bb845f26b

Upvotes: 1

ram
ram

Reputation: 527

Before doing this in Accessibility Inspector, don't forget to turn on "Larger Text" in your simulated device's settings: General -> Accessibility -> Larger Font. Else, the Accessibility Inspector won't show the dynamic font option.

enter image description here

Upvotes: 2

Tim
Tim

Reputation: 8399

As of iOS 10, it is possible to dynamically alter the dynamic type choice using the UITraitCollection API. See https://stackoverflow.com/a/43983241/1148702 for more info.

Upvotes: 1

Clafou
Clafou

Reputation: 15400

Although (to my knowledge) not documented, a launch argument can be used to define the initial Dynamic Type setting.

Key: UIPreferredContentSizeCategoryName

Value: One of the below

  • UICTContentSizeCategoryXS
  • UICTContentSizeCategoryS
  • UICTContentSizeCategoryM
  • UICTContentSizeCategoryL
  • UICTContentSizeCategoryXL
  • UICTContentSizeCategoryXXL
  • UICTContentSizeCategoryXXXL
  • UICTContentSizeCategoryAccessibilityM
  • UICTContentSizeCategoryAccessibilityL
  • UICTContentSizeCategoryAccessibilityXL
  • UICTContentSizeCategoryAccessibilityXXL
  • UICTContentSizeCategoryAccessibilityXXXL

Source of this undocumented key/values: GitHub.

A convenient way to do so is to add a launch argument to an Xcode scheme (add for example -UIPreferredContentSizeCategoryName UICTContentSizeCategoryXL under Arguments Passed On Launch), and this setting will apply when you run the app in Xcode. You can create multiple schemes with different Dynamic Type settings to switch between them.

If the purpose is creating screenshots using Fastlane Snapshot, the equivalent code is as follows:

app.launchArguments += [ "-UIPreferredContentSizeCategoryName", "UICTContentSizeCategoryXL" ]
app.launch()

Upvotes: 20

Related Questions