1. Tổng quan

Đây là bước đầu tiên để tích hợp thư viện lõi của Mobio SDK vào dự án Mobile App Android của bạn.

Đối tượng sử dụng: Developer Android.

2. Điều kiện tiên quyết

• Đã hoàn tất bước: Khai báo ứng dụng trên CDP và lấy thông tin cấu hình
• Đã tải xuống file gói thư viện mobio-sdk.aar cấp bởi hệ thống Mobio.

3. Quy trình cài đặt

Bước 1: Thêm thư viện Mobio SDK vào thư mục dự án

1. Tạo một thư mục con tên là libs trong thư mục app của dự án (Ví dụ: root_project/app/libs).
2. Copy file bản build mobio-sdk.aar vào thư mục libs vừa tạo.

Bước 2: Khai báo thư viện trong build.gradle (Module: app)

Tuỳ thuộc vào dự án của bạn sử dụng Groovy hay Kotlin, hãy mở file cấu hình tương ứng ở cấp Module và thêm mã code dưới đây vào khối cấu trúc dependencies {}.

Dự án sử dụng Groovy (build.gradle)

dependencies { 
 // Nạp thư viện SDK nội bộ
 implementation files("libs/mobio-sdk.aar") 

 // Khai báo các tiện ích Framework Google Firebase bắt buộc để Mobio hoạt động
 implementation 'androidx.appcompat:appcompat:1.7.0' 
 implementation 'androidx.work:work-runtime:2.9.0' 
 implementation platform('com.google.firebase:firebase-bom:32.2.2') 
 implementation 'com.google.firebase:firebase-messaging' 
 implementation 'com.google.code.gson:gson:2.10.1' 
 implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1' 
}

Dự án sử dụng Kotlin (build.gradle.kts)

dependencies { 
 // Nạp thư viện SDK nội bộ
 implementation(files("libs/mobio-sdk.aar")) 
 
 // Khai báo các tiện ích Framework Google Firebase bắt buộc để Mobio hoạt động
 implementation("androidx.appcompat:appcompat:1.7.0") 
 implementation("androidx.work:work-runtime:2.9.0")
 implementation(platform("com.google.firebase:firebase-bom:32.2.2")) 
 implementation("com.google.firebase:firebase-messaging") 
 implementation("com.google.code.gson:gson:2.10.1") 
 implementation("com.google.android.gms:play-services-ads-identifier:18.0.1") 
}

Bước 3: Cập nhật tính tương thích phiên bản Java

SDK của Mobio yêu cầu dự án chạy trên môi trường Java 8 trở lên. Hãy kiểm tra file build.gradle (hoặc build.gradle.kts) của module app. Nếu dự án chưa được cấu hình, hãy bổ sung Compile Options dưới đây vào thẻ môi trường android {}:

android { 
 // ...
 compileOptions { 
  sourceCompatibility JavaVersion.VERSION_1_8 
  targetCompatibility JavaVersion.VERSION_1_8 
 } 
}

4. Quy tắc Vận hành

• Sau khi khai báo xong, bắt buộc phải bấm lệnh Sync Now trên Android Studio để Engine hệ thống biên dịch và tải các Dependency tương ứng.
• Thư viện Push Framework: Không được phép xóa khai báo thư viện firebase-messaging hoặc play-services-ads-identifier. SDK Mobio bắt buộc sử dụng 2 nền tảng Base này của Google để cấp quyền thu nhận Message App Push và theo dõi chỉ danh thiết bị. Không có 2 Base File này, App có thể báo lỗi hệ thống ClassNotFoundException (Văng ứng dụng).

5. Các câu hỏi thường gặp (FAQ)

Chưa có thông tin cho phần này.

6. Bước tiếp theo

Cấu hình Permissions & Firebase Service trên Android