Playvoi/Assets/ShiroginSDK/README.md

5.4 KiB
Raw Blame History

📦 Shirogin SDK

Shirogin SDK, Unity projeleri için geliştirilen kapsamlı bir oyun içi servis paketidir. Tek bir yapı altında Reklam, Satın Alma (IAP), Analitik, Facebook, Remote Config ve Veri Yönetimi sistemlerini entegre eder. Ayrıca özel Editor araçları sayesinde geliştirme süreçlerini hızlandırır ve yönetimi kolaylaştırır.


🛠 Kurulum ve Setup Wizard

ShiroginSDK artık akıllı bir Kurulum Sihirbazı (Setup Wizard) ile birlikte gelmektedir.

  1. Core Paketi İçe Aktarın: ShiroginSDK Core paketini projenize sürükleyip bırakın.
  2. Setup Wizard: Yükleme tamamlandığında Setup Wizard penceresi otomatik olarak açılacaktır. (Açılmazsa: ShiroginSDK > 👋 Welcome menüsünü kullanın).
  3. Tek Tıkla Kurulum:
    • Setup Wizard, projenizdeki eksik temel paketleri (Unity IAP, Firebase, AppLovin vb.) analiz eder.
    • "⬇ Download & Install All Core" butonuna basarak tüm bağımlılıkları sırasıyla ve otomatik olarak kurun.
    • Unity Package Manager (UPM) paketleri (örn. TextMeshPro, Android Logcat) otomatik olarak Client.Add yöntemiyle projeye eklenir.

⚙️ Konfigürasyon

Kurulum sonrası Resources/ShiroginConfig dosyası üzerinden modülleri yönetebilirsiniz:

  • Enable/Disable: Kullanmayacağınız servisleri (örn. Facebook) tek tıkla kapatın.
  • API Keys: AppLovin Key, AppsFlyer Dev Key gibi anahtarları buradan girin.
  • Asset Manager: Dilediğiniz zaman ShiroginSDK > Asset Manager menüsünden paketlerinizi güncelleyebilir, dokümantasyonlarını indirebilir veya kaldırabilirsiniz.


🚀 Temel Özellikler

Kategori ıklama Versiyon / SDK
🎯 Reklam Sistemi AppLovin destekli ödüllü, banner ve interstitial reklam yönetimi AppLovin SDK 8.5.1
💳 Satın Alma (IAP) Unity IAP üzerinden ürün yönetimi, ödül tanımları ve event tabanlı izleme Unity IAP 4.13.0
📊 Analitik (Analytics) Firebase, AppsFlyer ve Facebook event sistemi ShiroginEvents yapısıyla birleştirilir Event-based Analytics Core
🔥 Firebase Service Analytics + Remote Config desteği, local cache fallback sistemiyle birlikte Firebase SDK 13.6.0
📱 Facebook SDK App Events, reklam kampanyası izleme ve kullanıcı giriş desteği Facebook SDK 18.0.0
🧠 AppsFlyer SDK Kurulum ve kullanıcı edinme (UA) analizleri AppsFlyer SDK 6.17.72
⚙️ Data System JSON tabanlı kayıt sistemi (BaseData) ile kalıcı veri yönetimi (Economy, Player, Settings...) Dahili Sistem
🧩 Popup & UI Framework DOTweenPro tabanlı popup animasyon sistemi, temalı UI desteği DOTween Pro 1.0.380
🧰 Editor Tools PlayerPrefs Editor, SDK Configurator, Theme Manager, RemoteConfig Importer PlayerPrefs Editor 1.2.4

🧠 Teknik Yapı

  • Modüler mimari: Her sistem ayrı servis sınıfları üzerinden yönetilir (IAPService, AdService, FirebaseService, AnalyticsService vs).
  • Event-driven yapı: Tüm servisler ShiroginEvents üzerinden haberleşir.
  • Scriptable Object tabanlı konfigürasyon: SDKConfig, StoreRepository, RemoteConfigDefinition gibi varlıklar editor içinde yönetilir.

🧾 Klasör Yapısı

Assets/
 └── ShiroginSDK/
      ├── Runtime/
      │    ├── Core/
      │    ├── Data/
      │    ├── Events/
      │    ├── IAP/
      │    ├── Services/
      │    ├── UI/
      ├── Editor/
      │    ├── Tools/
      │    └── Toolbar/
      └── Documents/
           └── (README, Kurulum Rehberleri, SDKConfig örnekleri)

📚 Dokümantasyon

Her modülün kurulum ve kullanım dökümanları ShiroginSDK/Documents klasörü altındadır:


🧩 Desteklenen Unity Sürümü

Unity 6000.0.60f1.


Hazırlayan: Emir Han MAMAK

Version: 1.1.0 (2025.12)