Pemasangan dan permulaan

Operasi Finteza SDK memerlukan Android 4.3 (API Tahap 18) atau lebih tinggi dan com.android.installreferrer:installreferrer pustaka. SDK tersebut boleh dipasang menggunakan Gradle atau secara manual dengan memuat turun pakejnya di https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Pemasangan melalui Gradle #

Untuk menghubungkan Finteza SDK, tambahkan pergantungan berikut kepada pergantungan bahagian bagi build.gradle fail projek anda:

pergantungan {
   //... lain-lain pergantungan
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Pemasangan manual #

Muat turun versi SDK terkini sebagai fail aar dan salin ia ke libs direktori projek anda. Seterusnya, masukkan fail aar SDK kepada projek tersebut sebagai pustaka.

Masukkan perkhidmatan berikut kepada manifes projek:

<service android:name="net.metaquotes.FintezaService" />

Tambahkan kebenaran:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Seterusnya, masukkan pergantungan berikut kepada build.gradle fail:

pergantungan {
   //... lain-lain pergantungan
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

Memulakan SDK dalam aplikasi #

Untuk memulakan, panggil Finteza.initialize kaedah dalam Application.onCreate atau Activity.onCreate pengendali:

Finteza.initialize(getApplication(), "{WEBSITE_ID}", "{WEBSITE_URL}", "{PRODUCT}");

Tetapkan ID laman web sebagai {WEBSITE_ID}. Ia dapat diperolehi dalam tetapan laman web (medan ID) pada panel Finteza. Seterusnya, tetapkan parameter:

Parameter

Jenis

Butiran

site

string

Nama domain laman web, sebagai contoh, "laman.saya.com".

product

string

Nama produk untuk digunakan sebagai awalan bagi melabel peristiwa yang dihantar kepada Finteza oleh aplikasi anda.

 

Anda memerlukannya untuk membezakan peristiwa merentas platform berbeza jika anda mempunyai aplikasi untuk PC, iOS, Android, dll. Sebagai contoh, jika anda menyatakan produk "Aplikasi Android" dan menghantar peristiwa "Pendaftaran", nama akhir peristiwa dalam Finteza akan menjadi "Pendaftaran Aplikasi Android".

 

Tetapkan null untuk mengelak penggunaan awalan.

 

Peristiwa pelancaran aplikasi #

Masukkan kod berikut kepada Activity.onCreate:

Finteza.activate()

Apabila activate dipanggil pada permulaan aplikasi pertama, SDK menghantar peristiwa "Install Finish" kepada Finteza (jika alawan produk dinyatakan, "{PRODUCT} Install Finish" dihantar).

Di samping itu, apabila memanggil activate, sesi kerja baharu bermula dan peristiwa "Session Start" didaftarkan (jika awalan produk ditetapkan, maka "{PRODUCT} Session Start").

Jika pengguna keluar daripada aplikasi, sesi semasa tamat. Jika aplikasi dilancarkan/diaktifkan kemudiannya, sesi baharu bermula.

Mesej penyahpepijatan #

Untuk menguji operasi SDK, anda boleh mendayakan output maklumat penyahpepijatan kepada konsol pembangun, ditapis mengikut jenis mesej:

Peristiwa sahaja

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Pengelogan penuh

Finteza.addLogging(LogUtil.LogLevel.ALL);

Ralat sahaja

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Untuk menyahdayakan mesej penyahpepijatan, panggil:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Contoh

Mesej penyahpepijatan berikut menunjukkan satu ralat penghantaran peristiwa disebabkan ketiadaan activate kaedah panggilan:

[event] tidak dapat menghantar peristiwa 'Book Load': panggil kaedah 'aktifkan' terlebih dahulu
← 
 →