5.4 KiB
5.4 KiB
📦 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.
- Core Paketi İçe Aktarın: ShiroginSDK Core paketini projenize sürükleyip bırakın.
- Setup Wizard: Yükleme tamamlandığında Setup Wizard penceresi otomatik olarak açılacaktır. (Açılmazsa:
ShiroginSDK > 👋 Welcomemenüsünü kullanın). - 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.Addyö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 Managermenüsünden paketlerinizi güncelleyebilir, dokümantasyonlarını indirebilir veya kaldırabilirsiniz.
🚀 Temel Özellikler
| Kategori | Açı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,AnalyticsServicevs). - Event-driven yapı: Tüm servisler
ShiroginEventsüzerinden haberleşir. - Scriptable Object tabanlı konfigürasyon:
SDKConfig,StoreRepository,RemoteConfigDefinitiongibi 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:
- 📊 AnalyticsService.md → Analitik sistemlerinin genel yapısı (Firebase, AppsFlyer, Facebook)
- 💳 IAPService.md → Satın alma sistemi ve ödül yönetimi
- 🔥 RemoteConfigService.md → Firebase Remote Config entegrasyonu
- 📱 FacebookService.md → Facebook SDK kurulumu ve event takibi
- 🎯 PopupService.md → Popup & UI animasyon sistemi
- 🎨 ThemeService.md → Tema yönetimi ve dinamik UI renk sistemi
- 🧰 Editor Tools → SDK Configurator, PlayerPrefs Editor ve diğer editör araçları
🧩 Desteklenen Unity Sürümü
Unity 6000.0.60f1.
Hazırlayan: Emir Han MAMAK
Version: 1.1.0 (2025.12)