iOS Agent FAQ

Q. The agent fails to build. (Invalid privacy manifest error)

A. Starting from version 4.2.5, the NetFUNNEL iOS agent has updated its privacyInfo file according to Apple's policy changes.
If you encounter this error, please make sure your agent version is up to date.

Q. The app crashes in the delegate.

A. Please ensure that UI-related logic is executed on the main thread.

Q. I want to check debugging log messages.

A. You can check log messages generated by the NetFUNNEL iOS agent as follows:

1. Set printLog: true in the initialization function.

info

It is recommended to set printLog: false when releasing your app.

Q. The waiting room is not displayed.

A. If you want to display the waiting room without allowing real user entries, set the entry allowance to 0 while keeping the waiting room enabled.

In the console, go to [Segment Settings → Basic Settings → Entry Allowance] and set the value to 0.

Q. I want to update the UI from a delegate.

A. Be cautious when updating the UI from a callback function. If you call UI elements such as Alert directly within the asynchronously running NetFUNNEL callback, the app may behave abnormally or crash.

When using NetFUNNEL callback functions, you must switch UI updates to the main thread by using DispatchQueue.main.async {}.

Below is an example of how to safely perform UI-related tasks on the main thread:

DispatchQueue.main.async {
    let alert = UIAlertController(title: "Notice", message: "Successfully entered.", preferredStyle: .alert)
    alert.addAction(UIAlertAction(title: "OK", style: .default, handler: nil))
    activity.present(alert, animated: true, completion: nil)
}

Q. How can I check the agent version?

A. You can check the agent version using the getVersion() function.

Function Name	Parameter	Return Value	Description
getVersion	N/A	String	Function that returns (checks) the NetFUNNEL agent version