Upgrade Guide to the back-port version: Android¶

At the 20th February 2018 all currently supported SDK minor versions got a back-port release that only includes changes related to the domain change. Please determine the minor version of the Repro SDK that you are currently using and upgrade to the highest patch level version.

All released back-ports of the Android SDK¶

2.10.1
2.9.10
2.8.3
2.7.11
2.6.12
2.5.14
2.4.1
2.3.17
2.2.1
2.1.23
2.0.5
1.2.10
1.1.48
1.0.2
0.15.1
0.14.6
0.13.23

Update process¶

In case you use the Android Studio¶

Determine the version of the SDK that you are currently using¶

Your app's app/build.gradle will contain the SDK version that you are currently using. If for example your version is 2.9.0, then please upgrade to the new back-port with version 2.9.10.

dependencies {
    ...
    compile 'io.repro:repro-android-sdk:2.9.0'
    ...
}

Updating to the back-port version¶

Enter the new back-port version into your app/build.gradle. In the example below the back-port version would be 2.9.10.

dependencies {
    ...
    compile 'io.repro:repro-android-sdk:2.9.10'
    ...
}

In case you use the Eclipse¶

Determine the version of the SDK that you are currently using¶

The jar file that is included in your workspace under repro > libs contains the version number that you are currently using. If for example your version is 2.9.0, then please upgrade to the new back-port with version 2.9.10.

Delete the SDK that you are using at the moment¶

Remove repro project from your workspace

Import the back-port version¶

Please download and extract the back-ported SDK version suited for Eclipse
- You can download them directly via https://cdn.reproio.com/android/libprj/repro-android-sdk-libprj-x.x.x.zip. For example if you want to download version 2.9.10 then the link would be: https://cdn.reproio.com/android/libprj/repro-android-sdk-libprj-2.9.10.zip.
Select File > Import...

Select Android > Existing Android Code into Workspace and click Next.

Specify the extracted directory as Root Directory, check Copy projects into workspace and click Finish.

Points to consider while upgrading the SDK¶

If you use Eclipse, use Repro's Push Notification functionality and you try to upgrade from Android SDK 1.1.2~1.1.28 to the back-port version 1.1.48, then you have to add the BroadcastReceiver listed below to your AndroidManifest.xml.

+    <receiver
+        android:name="io.repro.android.notification.IntentHandler"
+        android:exported="false">
+        <intent-filter>
+            <action android:name="io.repro.android.notification.IntentHandler.START_ACTIVITY" />
+        </intent-filter>
+    </receiver>

If you use Eclipse and you try to upgrade from Android SDK 1.1.2~1.1.29 to the back-port version 1.1.48, then you should delete the Activities listed below from your AndroidManifest.xml.

-   <activity
-       android:name="io.repro.android.message.MessageActivity"
-       android:theme="@style/io_repro_android_MessageActivityTheme"/>

If you use event triggers in WebViews and you use the Android SDK 1.1.2~1.1.37, then while you upgrade to SDK version 1.1.48, you should also update the URL that points to the Repro JavaScript library. The domain, as well as the file path will change like listed below.
- The domain changes from cdn.repro.io to cdn.reproio.com
- The file path changes from /js/v1/dummy.repro.js to /js/v2/repro.js

<head>
...
-   <script src="//cdn.repro.io/js/v1/dummy.repro.js" type="text/javascript" charset="utf-8"></script>
+   <script src="//cdn.reproio.com/js/v2/repro.js" type="text/javascript" charset="utf-8"></script>
...
</head>

In case that you limit the accessible domains of your app, you have to add *.reproio.com to the white-list as well.