Template:iOS Setting Up Development Environment - Revision history

ColinBrown: /* IPA processing failure */

2022-03-01T21:26:09Z

IPA processing failure

← Older revision		Revision as of 21:26, 1 March 2022
Line 51:		Line 51:
	<code>Assertion failed: Expected 4 archs in otool output:</code>		<code>Assertion failed: Expected 4 archs in otool output:</code>

	The error above is due to the "fat" (simulator+device) framework which will not appear if you have not enabled Bitcode. To build your app with full Bitcode support, it is recommended that you use a [[DCR_Video_iOS_SDK_xcframework\|XCFramework]].		The error above is due to the "fat" (simulator+device) framework which will not appear if you have not enabled Bitcode. To build your app with full Bitcode support, it is recommended that you use a [[DCR_Video_iOS_SDK_xcframework\|XCFramework]] to avoid the 4 archs in otool output message.

ColinBrown: /* IPA processing failure */

2022-03-01T21:22:24Z

IPA processing failure

← Older revision		Revision as of 21:22, 1 March 2022
Line 51:		Line 51:
	<code>Assertion failed: Expected 4 archs in otool output:</code>		<code>Assertion failed: Expected 4 archs in otool output:</code>

	The error above is due to the "fat" (simulator+device) framework which will not appear if you have not enabled Bitcode. To build your app with full Bitcode support, it is recommended that you use a XCFramework.		The error above is due to the "fat" (simulator+device) framework which will not appear if you have not enabled Bitcode. To build your app with full Bitcode support, it is recommended that you use a [[DCR_Video_iOS_SDK_xcframework\|XCFramework]].

ColinBrown: /* Setting up your Development Environment */

2022-03-01T21:20:34Z

Setting up your Development Environment

← Older revision		Revision as of 21:20, 1 March 2022
Line 40:		Line 40:
	@import NielsenAppApi;		@import NielsenAppApi;
	</syntaxhighlight>		</syntaxhighlight>

			==== xCode 12 building errors ====
			Developers who uses "fat" framework in their apps started reporting the following error that they get building the app in xCode 12.3+:
			<blockquote>Building for iOS Simulator, but the linked and embedded framework 'MyFramework.framework' was built for iOS + iOS Simulator.</blockquote>
			The binary framework contains different code for the same architecture in multiple places, and Xcode doesn’t know how to handle it. There is workaround that people recommend to use in such cases:
			* https://stackoverflow.com/questions/63267897/building-for-ios-simulator-but-the-linked-framework-framework-was-built
			* https://stackoverflow.com/questions/63932158/xcode12-issus-ld-building-for-ios-simulator-but-linking-in-object-file-built

			==== IPA processing failure ====
			<code>Assertion failed: Expected 4 archs in otool output:</code>

			The error above is due to the "fat" (simulator+device) framework which will not appear if you have not enabled Bitcode. To build your app with full Bitcode support, it is recommended that you use a XCFramework.

ColinBrown: /* Special Note for Static Framework */

2022-03-01T21:11:29Z

Special Note for Static Framework

← Older revision		Revision as of 21:11, 1 March 2022
Line 16:		Line 16:
	=== Special Note for Static Framework ===		=== Special Note for Static Framework ===
	Starting from 8.2.0.0 release framework is build from the mixed (swift + objc) source codse.		Starting from 8.2.0.0 release framework is build from the mixed (swift + objc) source codse.
	If static (xc)framework is integrated additional settings should be applied to fix build or runtime issues.		If [[iOS_Static_Framework_Setup\|static (xc)framework is integrated additional settings]] should be applied to fix build or runtime issues.

	=== Download Framework ===		=== Download Framework ===

ColinBrown: /* = Special Note for Static Framework */

2022-03-01T21:10:30Z

= Special Note for Static Framework

← Older revision		Revision as of 21:10, 1 March 2022
Line 14:		Line 14:
	<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>		<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>

	=== Special Note for Static Framework ==		=== Special Note for Static Framework ===
	Starting from 8.2.0.0 release framework is build from the mixed (swift + objc) source codse.		Starting from 8.2.0.0 release framework is build from the mixed (swift + objc) source codse.
	If static (xc)framework is integrated additional settings should be applied to fix build or runtime issues.		If static (xc)framework is integrated additional settings should be applied to fix build or runtime issues.

ColinBrown: /* Setting up your Development Environment */

2022-03-01T21:10:16Z

Setting up your Development Environment

← Older revision		Revision as of 21:10, 1 March 2022
Line 13:		Line 13:

	<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>		<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>

			=== Special Note for Static Framework ==
			Starting from 8.2.0.0 release framework is build from the mixed (swift + objc) source codse.
			If static (xc)framework is integrated additional settings should be applied to fix build or runtime issues.

	=== Download Framework ===		=== Download Framework ===

ColinBrown: Created page with "== Setting up your Development Environment == Prior to SDK Version 6.2.0.0 the IOS framework has been distributed as a static library packaged into framework bundle format...."

2021-08-23T20:58:14Z

Created page with "== Setting up your Development Environment == Prior to SDK Version 6.2.0.0 the IOS framework has been distributed as a static library packaged into framework bundle format...."

New page

== Setting up your Development Environment ==
Prior to SDK Version 6.2.0.0 the IOS framework has been distributed as a static library packaged into framework bundle format. Apple recommends to use dynamic framework, it has some benefits over static libraries like less executable file size of an app, faster startup time and native support in xCode IDE. Nielsen AppSDK has been transformed into dynamic framework in this release ([[iOS_Static_Framework_Setup|static framework]] is still available).

If migrating from the static library to this new dynamic framework, once implemented, unless your specific application requires, you can remove the following Frameworks that were once required:<code> [AdSupport, JavascriptCore, SystemConfiguration, Security, AVFoundation, libc++] </code>
<br>

The '''Dynamic framework''' is created as a fat framework. It means that it contains slices required for devices (armv7, arm64) as well as slices required for simulators (i386, x86_64). Simulator slices are needed to let clients build and debug their app on the simulators, but they should be removed before sending the app to the AppStore. The example of the shell script that should be added as a Run Script phase in the application can be [[DCR_Video_iOS_SDK#Removing_Simulators_.28Dynamic_Framework_Only.29|found below]].

'''[[DCR_Video_iOS_SDK_xcframework|XCFramework]]''' is solution for the problems described above Apple recommends to use XCFrameworks. In XCFramework, we no longer build a single framework with multiple architectures. Instead, we build one small framework for each combination of architecture and target and store it in its own folder. The top-level XCFramework folder have folders like ios-arm64, ios-arm64-simulator, etc. Each of these folders is its own framework, complete with headers, modules, and binary.

=== Configuring Xcode Development Environment ===
Starting with SDK version 6.0.0.0, the Nielsen App SDK is compatible with Apple iOS versions 8.0 and above. In addition, when using the dynamic framework, all the required frameworks are linked automatically as the are needed. More details can be found here: https://stackoverflow.com/questions/24902787/dont-we-need-to-link-framework-to-xcode-project-anymore

<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>

=== Download Framework ===
The first step is to download and copy the [[Special:Downloads|NielsenAppApi.framework]] bundle to the app project directory. (''Not required if using CocaPods'')

=== Add Framework ===
In the General tab for app configuration add NielsenAppApi.framework in the list of Embedded Binaries. (''Not required if using CocaPods'')

=== Add Path ===
Add path to the NielsenAppApi.framework in the Framework Search Paths build setting. (''Not required if using CocaPods'')

=== Import Framework ===
Add NielsenAppApi.framework module in the source file of your app:

==== Using Swift ====
Add the following:
<syntaxhighlight lang="swift">
import NielsenAppApi
</syntaxhighlight>

==== Using Objective-C ====
<syntaxhighlight lang ="objective-c">
@import NielsenAppApi;
</syntaxhighlight>