Hướng dẫn này trình bày quy trình từng bước để tích hợp Engage SDK vào ứng dụng của bạn.
Tài nguyên dùng chung
Bạn có thể sử dụng các tài nguyên sau để hỗ trợ quá trình tích hợp:
Ứng dụng xác minh
Một ứng dụng xác minh dùng để xác minh việc xuất bản nội dung trong giao diện người dùng.
Nguyên tắc phát hành nội dung
Tài liệu hướng dẫn cách xuất bản nội dung hiệu quả bằng API.
Bước 1: Phát triển bằng chế độ gỡ lỗi của SDK
Thêm Engage SDK vào tệp build.gradle và làm theo hướng dẫn tích hợp tương ứng dành riêng cho ngành dọc để hoàn tất quá trình tích hợp.
dependencies {
// Make sure you also include the repository in your project's
// build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.7'
}
Bước 2: Cài đặt ứng dụng xác minh
Ứng dụng xác minh là một ứng dụng Android mà bạn có thể dùng để xác minh rằng SDK tích hợp đang hoạt động. Ứng dụng này có những chức năng giúp nhà phát triển xác minh dữ liệu và ý định truyền tin.
Bước 3: Xác minh rằng dữ liệu hiển thị trong ứng dụng xác minh
Ứng dụng xác minh sẽ hiển thị từng cụm dưới dạng một hàng riêng biệt.
- Nhập tên gói của nhà phát triển đang phát hành dữ liệu.
- Xác minh rằng tất cả các thực thể trong cụm đã được phát hành.
- Xác minh rằng tất cả các trường trong thực thể đều được phát hành. Đối với mỗi mục trong hàng, bạn có thể nhấp vào hình ảnh áp phích để xác minh ý định.
- Xem xét thông tin tóm tắt cho các cấp ứng dụng, cụm và thực thể cho biết số lượng lỗi xác thực. Xem xét các thông báo lỗi xác thực xuất hiện bằng màu đỏ bên dưới mỗi trường có liên quan. Lỗi xác thực xảy ra khi các trường bắt buộc bị thiếu hoặc có giá trị không chính xác.
- Xác minh rằng bạn đã giải quyết tất cả lỗi xác thực. Trạng thái mẫu:
Bước 4: Xác minh luồng ý định truyền tin
Để xác minh ý định truyền tin, hãy nhấp vào nút ở đầu giao diện người dùng để kích hoạt logic truyền tin.
Sau khi hoàn tất các bước từ 1 đến 4, bạn đã hoàn thành việc kiểm thử quy trình tích hợp.
Bước 5: Tự chứng nhận quá trình tích hợp
Trước khi chúng tôi xem xét, bạn phải hoàn tất quy trình tự chứng nhận. Đây là một bước quan trọng để xác minh rằng quy trình tích hợp của bạn đã sẵn sàng và giúp đơn giản hoá quy trình xem xét.
Nhập tên gói rồi nhấp vào nút "Bắt đầu tự chứng nhận" trên trang chủ của ứng dụng xác minh.
Hình 7: Bắt đầu tự chứng nhận Trên trang tiếp theo, hãy chọn ngành dọc của bạn trong danh sách thả xuống. Thao tác này sẽ hiển thị danh sách các thử nghiệm cho thành phần dọc:
Dùng ứng dụng Verify để kiểm thử quá trình tích hợp theo từng trường hợp kiểm thử được hiển thị trên ứng dụng Verify.
- Thanh tiến trình cho biết số lượng kiểm thử đã thực hiện cho đến thời điểm hiện tại.
- Nhấp vào nút Xem chi tiết để xem các bước thực hiện kiểm thử và hành vi dự kiến, các quy trình xác minh thủ công bắt buộc.
- Phần giữa của trang tự chứng nhận sẽ hiển thị các cụm đã xuất bản.
- Nhấp vào nút Ghi lại kết quả kiểm tra để ghi lại kết quả kiểm tra. Đưa ra lý do nếu bạn đánh dấu một kiểm thử là không thành công hoặc bị bỏ qua.
- Sử dụng nút Back (Quay lại) và Next (Tiếp theo) để chuyển đến các kiểm thử trước và sau tương ứng.
- Nhấp vào nút Thoát kiểm thử hoặc đóng ứng dụng Xác minh ứng dụng bất cứ lúc nào để thoát kiểm thử. Phiên kiểm thử hiện tại sẽ tự động lưu và có thể tiếp tục hoặc chạy lại bất cứ lúc nào (ngay cả khi ứng dụng Verify bị đóng hoặc nếu thiết bị được khởi động lại). Khi bạn nhập cùng một tên gói và chọn cùng một danh mục ngành dọc khi bắt đầu tự chứng nhận, ứng dụng Verify sẽ hiện một lời nhắc hỏi xem bạn có muốn tiếp tục với phiên kiểm thử hiện tại hay không.
- Nhấp vào nút Tải phiên xuống để tải phiên kiểm thử hiện tại xuống dưới dạng tệp CSV. Bạn có thể chia sẻ tệp CSV này và tải phiên này vào ứng dụng Verify bằng nút "Tải phiên được chia sẻ" trên trang chủ của ứng dụng Verify. Xin lưu ý rằng chỉ các trường hợp kiểm thử và kết quả kiểm thử được lưu trong phiên đã tải xuống.
Sau khi hoàn tất kiểm thử, hãy nhấp vào nút Hoàn tất kiểm thử để tạo bản tóm tắt có thể tải xuống về quy trình kiểm thử tự chứng nhận.
Sau khi hoàn tất các bước từ 1 đến 5, bạn đã hoàn thành quy trình kiểm thử tích hợp.
Bước 6: Kiểm tra lại: Chuyển sang phiên bản SDK công khai
Sau khi gỡ lỗi xong, bạn phải cập nhật siêu dữ liệu trong tệp kê khai:
<application>
...
<meta-data
android:name="com.google.android.engage.service.ENV"
android:value="PRODUCTION"></meta-data>
</application>
Bước 7: Gửi cho Google APK có thể phát hành được
Gửi bản sao tệp APK sẵn sàng phát hành dưới dạng tệp đính kèm email tới địa chỉ engage-developers@google.com. Đồng thời, hãy đính kèm bản tóm tắt tự chứng nhận đã hoàn tất do ứng dụng Verify tạo. Google sẽ xác minh rằng quy trình tích hợp đang hoạt động như dự kiến. Sau khi Google xác minh việc tích hợp, bạn có thể gửi ứng dụng để phát hành công khai.
Bước 8: Phát hành APK lên Cửa hàng Play
Sau khi bạn được phê duyệt, hãy phát hành APK lên Cửa hàng Play. Sau khi bạn phát hành APK, hãy gửi email đến engage-developers@google.com kèm theo số phiên bản đã phát hành. Google sẽ phản hồi các bước tiếp theo.
Tải xuống
Trước khi tải xuống, bạn phải đồng ý với các điều khoản và điều kiện sau.