Cài đặt nhanh

Đưa một plugin LeonoPlugins vào game Godot và gọi hàm đầu tiên. Các bước giống nhau cho mọi plugin; bước riêng (key, setting) nằm trong trang của từng plugin.

Yêu cầu

• Godot 4.7 trở lên.
• Android: đã cài Android SDK + export template trong Godot.
• iOS: máy Mac có Xcode để export/ký app.

Cài addon

1. Tải addon Mỗi file zip có sẵn thư mục addons/leono_<tên>/ kèm thư viện Android đã build:
   Tất cả plugin NativeUtils Firebase IAP
   Muốn tự build (hoặc cần thư viện iOS): xem Build.
2. Giải nén vào game Giải nén zip vào thư mục gốc project Godot (nơi có project.godot), kết quả:

   res://addons/leono_nativeutils/
   ├── plugin.cfg, plugin.gd, native_utils.gd, deps.json
   ├── leono_nativeutils.gdextension
   └── bin/
       ├── android/leono_nativeutils.aar
       └── ios/leono_nativeutils.ios.template_{debug,release}.xcframework

3. Bật plugin Project → Project Settings → Plugins → tick plugin. Autoload của plugin (ví dụ NativeUtils) được thêm tự động.
4. Cấu hình export Làm theo nền tảng ở mục bên dưới.

Cấu hình export

Gọi hàm đầu tiên

Code game chỉ gọi autoload. Ví dụ với NativeUtils:

func _ready() -> void:
    var app := NativeUtils.get_app_info()
    print("Phiên bản: ", app.version_name)

    # Hàm bất đồng bộ dùng await
    var ref := await NativeUtils.get_install_referrer()
    print("Nguồn cài: ", ref.get("params", {}).get("utm_source", "organic"))

Chạy trong editor

Trong editor và bản PC không có phần native: mọi hàm vẫn chạy và trả giá trị mặc định an toàn (chuỗi rỗng, {}, -1…), hàm async vẫn trả kết quả. Dùng is_native() nếu cần phân biệt.

if not NativeUtils.is_native():
    print("Đang chạy trong editor — dữ liệu giả lập")