White Screen on iOS

[leonelgregioauler]

Hi all !!

I have created an app. Into Android platform it works fine ! But into iOS platform, the app starts with a white screen.
I have low experience with iOS apps, it can be a simple problem, but I don't know how to resolve.
I'm using MacInCloud plan.
The problem occur in Simulator and into TestFlight.

Below, print and informations about versions and tests:

Thanks in advance !!

Versions:

Tests:

iPhone 14 and 14 ProMax

iPhone 15 and 15 ProMax

Debug:

iPhone 14 and 14 ProMax

2025-06-26 14:10:22.634442-0400 Howse[39389:515607] [SceneConfiguration] Info.plist contained no UIScene configuration dictionary (looking for configuration named "(no name)")
2025-06-26 14:10:22.638745-0400 Howse[39389:515607] Apache Cordova iOS platform version 7.1.1 is starting.
2025-06-26 14:10:22.650126-0400 Howse[39389:515607] Could not load the "LaunchStoryboard" image referenced from a nib in the bundle with identifier "com.leonelgregioauler.vistorias"
2025-06-26 14:10:23.006712-0400 Howse[39389:515607] The preference key "AllowNewWindows" is not defined and will default to "FALSE"
2025-06-26 14:10:23.007180-0400 Howse[39389:515607] The preference key "MediaPlaybackAllowsAirPlay" is not defined and will default to "TRUE"
2025-06-26 14:10:23.007287-0400 Howse[39389:515607] The preference key "LimitsNavigationsToAppBoundDomains" is not defined and will default to "FALSE"
2025-06-26 14:10:23.009062-0400 Howse[39389:515607] The preference key "AllowBackForwardNavigationGestures" is not defined and will default to "FALSE"
2025-06-26 14:10:23.009128-0400 Howse[39389:515607] The preference key "Allow3DTouchLinkPreview" is not defined and will default to "TRUE"
2025-06-26 14:10:23.009169-0400 Howse[39389:515607] CDVWebViewEngine will reload WKWebView if required on resume
2025-06-26 14:10:23.009210-0400 Howse[39389:515607] Using WKWebView
2025-06-26 14:10:23.009521-0400 Howse[39389:515607] [CDVTimer][console] 0.016093ms
2025-06-26 14:10:23.009604-0400 Howse[39389:515607] [CDVTimer][handleopenurl] 0.018954ms
2025-06-26 14:10:23.010063-0400 Howse[39389:515607] [CDVTimer][intentandnavigationfilter] 0.419021ms
2025-06-26 14:10:23.010127-0400 Howse[39389:515607] [CDVTimer][gesturehandler] 0.018001ms
2025-06-26 14:10:23.010335-0400 Howse[39389:515607] [CDVTimer][inappbrowser] 0.164986ms
2025-06-26 14:10:23.010377-0400 Howse[39389:515607] [CDVTimer][TotalPluginStartup] 0.879049ms
2025-06-26 14:10:24.092967-0400 Howse[39389:515607] IAB.close() called but it was already closed.
2025-06-26 14:10:24.421874-0400 Howse[39389:515607] App carregando...
2025-06-26 14:10:24.441060-0400 Howse[39389:515607] The preference key "AutoHideSplashScreen" is not defined and will default to "TRUE"
2025-06-26 14:10:24.475787-0400 Howse[39389:515607] OPEN database: App-Vistorias.db
2025-06-26 14:10:24.476084-0400 Howse[39389:515607] -[SQLitePlugin pluginInitialize] [Line 38] Initializing SQLitePlugin
2025-06-26 14:10:24.476268-0400 Howse[39389:515607] -[SQLitePlugin pluginInitialize] [Line 45] Detected docs path: /Users/user943065/Library/Developer/CoreSimulator/Devices/D42C1F92-46EB-4687-A06F-D2F4A37E731E/data/Containers/Data/Application/17F64562-9189-45B6-BE7E-FF02A0731D56/Documents
2025-06-26 14:10:24.476325-0400 Howse[39389:515607] -[SQLitePlugin pluginInitialize] [Line 49] Detected Library path: /Users/user943065/Library/Developer/CoreSimulator/Devices/D42C1F92-46EB-4687-A06F-D2F4A37E731E/data/Containers/Data/Application/17F64562-9189-45B6-BE7E-FF02A0731D56/Library
2025-06-26 14:10:24.476542-0400 Howse[39389:515607] -[SQLitePlugin pluginInitialize] [Line 71] no cloud sync directory created with path: /Users/user943065/Library/Developer/CoreSimulator/Devices/D42C1F92-46EB-4687-A06F-D2F4A37E731E/data/Containers/Data/Application/17F64562-9189-45B6-BE7E-FF02A0731D56/Library/LocalDatabase
2025-06-26 14:10:24.476665-0400 Howse[39389:515607] -[SQLitePlugin pluginInitialize] [Line 93] no cloud sync at path: /Users/user943065/Library/Developer/CoreSimulator/Devices/D42C1F92-46EB-4687-A06F-D2F4A37E731E/data/Containers/Data/Application/17F64562-9189-45B6-BE7E-FF02A0731D56/Library/LocalDatabase
2025-06-26 14:10:24.476750-0400 Howse[39389:516380] -[SQLitePlugin closeNow:] [Line 233] close: db name was not open: App-Vistorias.db
2025-06-26 14:10:24.477943-0400 Howse[39389:516388] -[SQLitePlugin openNow:] [Line 176] open full db path: /Users/user943065/Library/Developer/CoreSimulator/Devices/D42C1F92-46EB-4687-A06F-D2F4A37E731E/data/Containers/Data/Application/17F64562-9189-45B6-BE7E-FF02A0731D56/Library/LocalDatabase/App-Vistorias.db
2025-06-26 14:10:24.485690-0400 Howse[39389:515607] OPEN database: App-Vistorias.db - OK
2025-06-26 14:10:24.485786-0400 Howse[39389:515607] DB opened: App-Vistorias.db

iPhone 15 and 15 ProMax

Apache Cordova iOS platform version 7.1.1 is starting.
Warning: -[BETextInput attributedMarkedText] is unimplemented
The preference key "AllowNewWindows" is not defined and will default to "FALSE"
The preference key "MediaPlaybackAllowsAirPlay" is not defined and will default to "TRUE"
The preference key "LimitsNavigationsToAppBoundDomains" is not defined and will default to "FALSE"
The preference key "InspectableWebview" is not defined and will default to "TRUE"
The preference key "AllowBackForwardNavigationGestures" is not defined and will default to "FALSE"
The preference key "Allow3DTouchLinkPreview" is not defined and will default to "TRUE"
CDVWebViewEngine will reload WKWebView if required on resume
Using WKWebView
[CDVTimer][console] 0.020981ms
[CDVTimer][handleopenurl] 0.012040ms
[CDVTimer][intentandnavigationfilter] 0.425935ms
[CDVTimer][gesturehandler] 0.015974ms
[CDVTimer][inappbrowser] 0.193000ms
[CDVTimer][TotalPluginStartup] 0.999928ms
Failed to resolve host network app id
Failed to request query parameters from WebPrivacy.
IAB.close() called but it was already closed.
Failed to request allowed query parameters from WebPrivacy.
App carregando...
The preference key "AutoHideSplashScreen" is not defined and will default to "TRUE"
OPEN database: App-Vistorias.db
-[SQLitePlugin pluginInitialize] [Line 38] Initializing SQLitePlugin
-[SQLitePlugin pluginInitialize] [Line 45] Detected docs path: /Users/user943065/Library/Developer/CoreSimulator/Devices/0500DBFC-C445-49C6-AF89-FD5FE909EF2B/data/Containers/Data/Application/9444363A-2E5A-46DB-BDEE-B0D7CF0DCA92/Documents
-[SQLitePlugin pluginInitialize] [Line 49] Detected Library path: /Users/user943065/Library/Developer/CoreSimulator/Devices/0500DBFC-C445-49C6-AF89-FD5FE909EF2B/data/Containers/Data/Application/9444363A-2E5A-46DB-BDEE-B0D7CF0DCA92/Library
-[SQLitePlugin pluginInitialize] [Line 71] no cloud sync directory created with path: /Users/user943065/Library/Developer/CoreSimulator/Devices/0500DBFC-C445-49C6-AF89-FD5FE909EF2B/data/Containers/Data/Application/9444363A-2E5A-46DB-BDEE-B0D7CF0DCA92/Library/LocalDatabase
-[SQLitePlugin pluginInitialize] [Line 93] no cloud sync at path: /Users/user943065/Library/Developer/CoreSimulator/Devices/0500DBFC-C445-49C6-AF89-FD5FE909EF2B/data/Containers/Data/Application/9444363A-2E5A-46DB-BDEE-B0D7CF0DCA92/Library/LocalDatabase
-[SQLitePlugin closeNow:] [Line 233] close: db name was not open: App-Vistorias.db
-[SQLitePlugin openNow:] [Line 176] open full db path: /Users/user943065/Library/Developer/CoreSimulator/Devices/0500DBFC-C445-49C6-AF89-FD5FE909EF2B/data/Containers/Data/Application/9444363A-2E5A-46DB-BDEE-B0D7CF0DCA92/Library/LocalDatabase/App-Vistorias.db
OPEN database: App-Vistorias.db - OK
DB opened: App-Vistorias.db

[breautek]

A white screen probably indicates some kind of JS error (which may not be printed in the XCode console) preventing your app from launching completely.

So I'd recommend using Safari to remote inspect the webview. (More details on my blog, just scroll down to the iOS section).

One important note on the web inspector is that events that occurred before the inspector was attached is not logged, so if you're having startup issues like this, you'll need to refresh the webview after the inspector is attached, which you can do by pressing cmd + r (or however to send a cmd +r keystroke in macincloud) while the inspector is attached.

Doing this might give you better insights on what is happening and why your app isn't launching as expected.

[leonelgregioauler]

Thank you @breautek !!

I'm going to follow your tips now !
Thank you very much for your promptness !!

[leonelgregioauler]

I found out !

This is an error due to static files.

For example, into index.html file, I was made the Firebase static files import:

The same problem occurs with the axios library.

What is the way to do the import for iOS ? I need a way that works into Android and iOS.

[breautek]

the loading errors refers to the map files, not the js sources themselves. Unless crafted to load from a remotely accessible server, they always fail in webviews because the web inspector (which runs on a workstation) doesn't have direct access to the local filesystem of the device where the map files are stored (usually beside the js sources). The map files simply provides original sources to the web inspector.

The fact that the web inspector is attempting to load the map files suggest that the respective js sources are being loaded, so I don't think it's an issue of firebase or axios failing to load, at least based on the screenshots it doesn't indicate that their sources are failing to load.

What is the way to do the import for iOS ? I need a way that works into Android and iOS.

To answer this question though, standard web behaviour applies. In your HTML, you have script references using a relative js/... path, which will be relative to the directory that the HTML file resides in. Assuming you're using the same file/folder structure within the www directory for both android and ios, then it should work in both platforms as far as loading goes.

[leonelgregioauler]

You're right !

The problem is on map files.

Into the firebase and axios libs, exists a call to map files. I deleted because I don't need them.

The JS errors into console was resolved, but the white screen keeps apearing

I followed the @GitToTheHub tips solving the problem !!

Thanks for all !! Your helps was very important !!

[GitToTheHub]

Hi,

I see in your console the paths are set to file-uris like file://null/Users/..., so you don't set an origin. Please try to set a hostname and scheme for your app in your config.xml like:

<platform name="ios">
  <preference name="scheme" value="app" />
</platform>

<preference name="hostname" value="localhost" />

This will give your app the origin localhost and you will get also better JavaScript errors.

[leonelgregioauler]

Hi !

It works fine !!!

I reported the solution into the chat above !!

Thank you so much !!

[GitToTheHub]

You're welcome :)

[leonelgregioauler]

Done !