Requirements for the Android SDK

Before you install the SDKs, understand the external components and extensions used with the SDKs and ensure your devices meet all requirements:

Android SDK

The UI SDK and Core SDK require Android 6.0 (API Level 23), also known as Marshmallow, or higher.

New Relic

If you use the New Relic Android agent with the SDKs, use New Relic Android agent version 7.2.0 or higher. Also, add this code to the build.gradle file. This requirement is essential to avoid server-sent event connection failures due to a dependency conflict between New Relic and OkHttp. See the New Relic and OkHttp documentation.

1newrelic {
2    excludePackageInstrumentation("("okhttp3.sse.internal.RealEventSource")")
3}

Zetetic SQLCipher

SQLCipher Community Edition is an open source extension to SQLite that supports database-level encryption. The UI SDK uses the SQLCipher extension.

1Copyright (c) 2005, ZETETIC LLC
2All rights reserved.
3
4Redistribution and use in source and binary forms, with or without
5modification, are permitted provided that the following conditions are met:
6* Redistributions of source code must retain the above copyright
7  notice, this list of conditions and the following disclaimer.
8* Redistributions in binary form must reproduce the above copyright
9  notice, this list of conditions and the following disclaimer in the
10  documentation and/or other materials provided with the distribution.
11* Neither the name of the ZETETIC LLC nor the
12  names of its contributors may be used to endorse or promote products
13  derived from this software without specific prior written permission.
14
15THIS SOFTWARE IS PROVIDED BY ZETETIC LLC ''AS IS'' AND ANY
16EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18DISCLAIMED. IN NO EVENT SHALL ZETETIC LLC BE LIABLE FOR ANY
19DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Per SQLCipher’s guidelines, if you use the Salesforce custom library, please include the SQLCipher Community Edition license and copyright statement in your application and documents. You can find more information about the guidelines at https://www.zetetic.net/sqlcipher/community/.