Instructions to add the screen params of new iOS devices to the Cardboard SDK

AI-generated Key Takeaways

• The Cardboard SDK requires updating screen_params.mm annually to work with new iOS devices.

• Information for updating screen_params.mm, such as model strings and DPI values, can be found on websites like theapplewiki.com and Apple's technical specifications pages.

• It is recommended to review the history of screen_params to ensure accurate updates are being made.

• If using the XR Plugin, a new GfxPluginCardboard.a file needs to be generated with the updated screen_params.mm.

Each year, new iOS devices are released. In order to make the Cardboard SDK work with these new devices, it is required to update screen_params.mm.

Source of information

• Model strings can be obtained from https://theapplewiki.com/wiki/Models.
• DPI (also called PPI) value can be taken from Apple's technical specifications. For example, for iPhone 15 https://www.apple.com/iphone-15/specs/.

What needs to be updated

Take a look at the history of screen_params to ensure that the correct lines are being updated.

Update the XR Plugin with the new screen param files

If the XR Plugin is being used, it is required to generate a new GfxPluginCardboard.a with the updated screen_params.mm file.

Follow the steps in the "Download and build the demo app" section from the Quickstart up to step 2 to open Cardboard.xcworkspace workspace in XCode. Select the sdk module and then Generic iOS Device as the target device (or choose to build for a specific phone if that suits your needs better). Build the sdk module, copy the generated .a file and replace the GfxPluginCardboard.a file in cardboard-xr-plugin/Runtime/iOS/.