Skip to main content

Native Android

This page describes how to migrate your application from using PinchSDK to preliminary release of Kettle.

Replace repository

  1. Remove the maven repository https://fluxloop.jfrog.io/artifactory/pinch.
  2. Add the maven repository https://artifacts.kogenta.com/release.

Replace implementation reference

  1. Remove implementation 'com.fluxloop.pinch:pinch-sdk:x.x.x'.
  2. Add implementation 'com.kogenta.kettle:kettle-sdk:1.0.0'.

Replace meta-data in AndroidManifest.xml

  1. Key com.fluxloop.pinch.sdk.API_KEY has been renamed to com.kogenta.kettle.sdk.API_KEY.
  2. Key com.fluxloop.pinch.sdk.PRODUCTION_MODE has been renamed to com.kogenta.kettle.sdk.PRODUCTION_MODE.

Replace imports

  1. Replace all occurrences of import com.fluxloop.pinch.sdk. with import com.kogenta.kettle.sdk..
  2. Replace all occurrences of import com.fluxloop.pinch.common. with import com.kogenta.kettle.common..

Replace calls to Pinch

  1. Replace all occurrences of Pinch. with Kettle..
  2. Replace all occurrences of PinchMessagingCenter. with KettleMessagingCenter.. The action PINCH has been replaced with KETTLE.
  3. Replace all occurrences of PinchMessage with KettleMessage.
  4. Replace all occurrences of PinchMetrics. with KettleMetrics..
  5. Replace all occurrences of Pinch.Provider.MOTION with KettleModule.ACTIVITY.
  6. Replace all occurrences of Pinch.Provider.LOCATION with KettleModule.LOCATION.
  7. Replace all occurrences of Pinch.Provider.BLUETOOTH with KettleModule.BLUETOOTH.
  8. Replace all occurrences of Pinch.Consent. with KettleConsent..

Obsolete methods and replacement paths

messagingId

This variable has been removed.

  • Use pushToken to send your push token to Kettle.
  • Use externalId to send your user identifier to Kettle.
  • Use identifier to retrieve the Kettle ID for the user.

start

  • This method can no longer be called without providers.
  • This method will no longer collect data unless consent has been given with grant().