Before you start the installation, verify that your system and Android device comply with the LuciadCPillar Hardware and software requirements.
Installing LuciadCPillar for Java or Kotlin Android development
To install LuciadCPillar for Java Android development, build and deploy the Java samples:
-
Extract these archives to the same directory:
-
Extract the
LuciadCPillar_Pro-Android.zip
archive. -
Extract the
LuciadCPillar_Pro_Documentation.zip
archive. -
Extract the
LuciadCPillar_Pro_Data.zip
archive.
-
-
Copy your LuciadCPillar license file, named
luciadcpillar_development.txt
, into the folderlicenses
. -
Copy the
Data
directory of LuciadCPillar to/sdcard/Documents/LuciadCPillar/Data
on a connected Android device:-
You can copy the data from the command line: in the root directory of your LuciadCPillar installation, execute
adb push Data /sdcard/Documents/LuciadCPillar/Data
. -
Alternatively, you can use a file explorer to copy the data to the
Documents/LuciadCPillar/Data
directory on your device.This data is only required to run the samples.
-
-
Open Android Studio and click Open.
-
Select the folder
java\android\samples
in your LuciadCPillar installation folder.
Android Studio initializes the samples project using thegradle
build system. -
Make sure that Android Studio points to valid JDK and Android SDK directories. Go to File > Settings > Build, Execution, Deployment > Built Tools > Gradle and File > Project Structure > SDK Location to validate and configure those directories.
-
-
Build and deploy the samples to a connected Android device. To prepare the Android device for sample launching and debugging:
-
Enable the debugging mode on the device. See the documentation specific to the device and its Android version for details.
-
Connect the device to the development system. A USB connection is recommended.
-
Allow the sample app to access the files on the device. Once you installed a sample app on the device, you must authorize it once to access the device storage.
-
-
Select a sample from the run/debug configurations drop-down menu in the toolbar menu,
dataformats
for example, and run it.When a LuciadCPillar sample is launched, it will ask for the
All files access
permission. This permission is needed to access sample data that is stored on the SD card of your phone. Without the permission, the samples will not function correctly. For more information about permissions related to files access refer to the Android Storage overview documentation.
Troubleshooting
See troubleshooting for commonly encountered problems.