AmySockanathan: Update "grade" to "gradle"

2025-08-14T18:05:04Z

Update "grade" to "gradle"

← Older revision		Revision as of 18:05, 14 August 2025
Line 27:		Line 27:

	Please add Nielsen app SDK as compile time dependency inside build.gradle file as below		Please add Nielsen app SDK as compile time dependency inside build.gradle file as below
	=== ~~grade~~ 4.x and above ===		=== gradle 4.x and above ===
	For gradle version starting with 4.x add the following line inside dependencies section of build.gradle file.<br>		For gradle version starting with 4.x add the following line inside dependencies section of build.gradle file.<br>
	<source lang="java">implementation 'com.nielsenappsdk:${market}:${version}'</source>		<source lang="java">implementation 'com.nielsenappsdk:${market}:${version}'</source>
Line 37:		Line 37:
	</source>		</source>

	=== ~~grade~~ prior to 4.x ===		=== gradle prior to 4.x ===
	For gradle version previous to 4.x add below line inside dependencies section of build.gradle file.		For gradle version previous to 4.x add below line inside dependencies section of build.gradle file.
	<source lang="java">compile 'com.nielsenappsdk:${market}:${version}'</source>		<source lang="java">compile 'com.nielsenappsdk:${market}:${version}'</source>

ColinBrown at 20:13, 21 September 2021

2021-09-21T20:13:44Z

Show changes

LaMarHolmes at 16:25, 10 June 2020

2020-06-10T16:25:44Z

← Older revision		Revision as of 16:25, 10 June 2020
Line 3:		Line 3:

	__NOTOC__		__NOTOC__
	To upgrade ~~the~~ Nielsen Android ~~AppSDK either integrate directly within the application~~ through the ~~use of a CocoaPod or~~ Gradle~~, or download~~ the latest version directly from the [https://engineeringportal.nielsen.com/docs/Special:Downloads Engineering Portal Downloads Page].		This guide shows how to upgrade Nielsen's Android SDK. The preferred method is through the Artifactory method with Gradle. There is also the option to upgrade with downloading the latest SDK version directly from the [https://engineeringportal.nielsen.com/docs/Special:Downloads Engineering Portal Downloads Page].

	= How to install the Nielsen AppSDK using Gradle for Android =		= How to install the Nielsen AppSDK using Gradle for Android =

LaMarHolmes: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital NOTOC To upgrade the Nielsen Android AppSDK either integrate d..."

2020-06-10T16:21:18Z

Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital __NOTOC__ To upgrade the Nielsen Android AppSDK either integrate d..."

New page

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}}
[[Category:Digital]]

__NOTOC__
To upgrade the Nielsen Android AppSDK either integrate directly within the application through the use of a CocoaPod or Gradle, or download the latest version directly from the [https://engineeringportal.nielsen.com/docs/Special:Downloads Engineering Portal Downloads Page].

= How to install the Nielsen AppSDK using Gradle for Android =
Below are the steps which need to be performed by app developers to integrate the Nielsen App SDK within an Android application.

== Update gradle.properties ==
The first step is to add the credentials received from Nielsen into your '''gradle.properties''' file, typically near the end of the file. We recommend using the version in your home folder (Global Properties). Gradle looks for '''gradle.properties''' files in this sequence:
* <code>gradle.properties</code> in project root directory.
* <code>gradle.properties</code> in GRADLE_USER_HOME directory.
* system properties, e.g. when <code>-Dgradle.user.home</code> is set on the command line.

Properties from one file will override the properties from the previous ones (so file in gradle user home has precedence over the others, and file in sub-project has precedence over the one in project root).

Reference: https://gradle.org/docs/current/userguide/build_environment.html

<source lang="java">machine raw.githubusercontent.com
nielsen_user=<Nielsen App SDK client>
nielsen_authCode=<Auth token></source>
 
<blockquote>
[[Image:AlertIcon.png|left|60px|link=|class=smallIcon]] Please do not upload any file to github or bitbucket containing the credentials above.
This will automatically lock your access.
</blockquote>

== Credentials ==
Obtain credentials '''[[Digital Downloads| → here ←]]'''

== Add Nielsen Maven Repository ==

Please add the Nielsen maven repository inside the repositories section of your app's module build.gradle file like below:

<source lang="java">android{
repositories {
//Copy below code inside repository section of app’s build.gradle file
maven { url 'https://raw.githubusercontent.com/NielsenDigitalSDK/nielsenappsdk-android/master/'
credentials {
//Make sure you add nielsen_user and nielsen_passwd with respective nielsen provided
// values to global gradle.properties file
username = project.property("nielsen_user")
password = project.property("nielsen_authCode")
}
authentication {
basic(BasicAuthentication)
}
}
}

}</source>

== Add gradle dependency ==

Please add Nielsen app SDK as compile time dependency inside build.gradle file as below
=== gradle 4.x and above ===
For gradle version starting with 4.x add the following line inside dependencies section of build.gradle file.

<source lang="java">implementation 'com.nielsenappsdk:${flavour}:${version}'</source>

=== gradle prior to 4.x ===
For gradle version previous to 4.x add below line inside dependencies section of build.gradle file.

<source lang="java">compile 'com.nielsenappsdk:${flavour}:${version}'</source>

== Version Control ==
It is recommended to use <code> + </code> to ensure you receive the most recent version of the NielsenSDK.
<source lang="java">compile 'com.nielsenappsdk:${flavour}:${version}'</source>
 
and a sample is:
<source lang="java">
dependencies { ....
implementation 'com.nielsenappsdk:globalx:+'
}
</source>
 
However a specific version can also be requested. To specify a version, please replace <code>${version}</code> with required Nielsen App SDK release.
<source lang="java">
dependencies { ....
implementation 'com.nielsenappsdk:globalx:7.1.0.0'
}
</source>
 
<blockquote>If using version control, a warning message will be displayed within the console trace during the build of your app,
and it will show all sdk versions released to-date, allowing a developer to select a more recent build if desired.</blockquote>

== Flavor Control ==
To specify a specific flavor of the Nielsen SDK, please replace <code>${flavor}</code> with one of below flavor types:
{| class="wikitable"
|-
!App Flavor Name !! Description !!
|-
|com.nielsenappsdk:globalx||GLOBAL flavor of appsdk for androidx apps|| Recommended
|-
|com.nielsenappsdk:global||GLOBAL flavor of appsdk for non androidx apps||
|}

<blockquote>It is recommended to use Androidx version whenever possible.</blockquote>
 
Below is an example for dependency

<source lang="java">
dependencies { ....
implementation 'com.nielsenappsdk:globalx:+'
}
</source>

== Ensuring you have the latest release information ==
It is recommended to use the most recent version of the NielsenSDK by using the following:
<source lang="java">
dependencies { ....
implementation 'com.nielsenappsdk:globalx:+'
}
</source>

In addition, please add below gradle task inside your <code> build.gradle (Module:app)</code> or <code>build.gradle(Project:My-app)</code> file to fetch latest release details of nielsen app sdk as below:

<blockquote>Please note: The <code> build.gradle (Module:app)</code> can overwrite the <code>build.gradle(Project:My-app)</code>.</blockquote>

<source lang="java">task NielsenSdkReleaseCheck {
def login_details = project.property("nielsen_user")+":"+project.property("nielsen_authCode")
def p = ['curl', '-u',login_details ,"https://raw.githubusercontent.com/NielsenDigitalSDK/nielsenappsdk-android/master/com/nielsenappsdk/global/NielsenAppSdk-ReadMe.md"].execute().text
project.logger.log(LogLevel.ERROR,p)
}
preBuild.dependsOn('NielsenSdkReleaseCheck')</source>

== Sync ==

If you are finished with all previous steps then you can sync your build.gradle and after successful build you are ready to use Nielsen App SDK library in your code.

 

= How to install the Nielsen AppSDK using latest downloaded version of SDK =
The first step is to go to [https://engineeringportal.nielsen.com/docs/Special:Downloads Engineering Portal Downloads Page] fill out the download request sheet.

Once approved for the latest AppSDK, download the folder and unzip it. Next find the appsdk.jar then drag and drop it in your build replacing the appsdk.jar that is currently being utilized in your application.

Once the latest appsdk.jar is integrated into the application make sure that implementation is still functional by testing your application.

For more information on setting up DCR Measurement using the Android SDK : [https://engineeringportal.nielsen.com/docs/DCR_Video_Android_SDK DCR Video Android SDK]

For more information on setting up DTVR Measurement using the Android SDK : [https://engineeringportal.nielsen.com/docs/DTVR_Android_SDK DTVR Video Android SDK]

Android SDK Upgrade - Revision history

AmySockanathan: Update "grade" to "gradle"

ColinBrown at 20:13, 21 September 2021

LaMarHolmes at 16:25, 10 June 2020

LaMarHolmes: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital __NOTOC__ To upgrade the Nielsen Android AppSDK either integrate d..."

LaMarHolmes: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital NOTOC To upgrade the Nielsen Android AppSDK either integrate d..."