76 lines
No EOL
4.1 KiB
Markdown
76 lines
No EOL
4.1 KiB
Markdown
# 📦 **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.
|
||
|
||
---
|
||
|
||
## 🚀 **Temel Özellikler**
|
||
|
||
| Kategori | Açıklama | Versiyon / SDK |
|
||
| --------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------- |
|
||
| 🎯 **Reklam Sistemi** | AppLovin destekli ödüllü, banner ve interstitial reklam yönetimi | AppLovin SDK **8.4.2** |
|
||
| 💳 **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 **12.8.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.16.2** |
|
||
| ⚙️ **Data System** | JSON tabanlı kayıt sistemi (`BaseData`) ile kalıcı veri yönetimi (Economy, Player, Settings...) | Dahili Sistem |
|
||
| 🧩 **Popup & UI Framework** | DOTween tabanlı popup animasyon sistemi, temalı UI desteği | DOTween Pro **1.2.632** |
|
||
| 🧰 **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:
|
||
|
||
* [📊 **AnalyticsService.md**](Documents/Analytics/AnalyticsService.md) → Analitik sistemlerinin genel yapısı (Firebase, AppsFlyer, Facebook)
|
||
* [💳 **IAPService.md**](Documents/IAP/IAPService.md) → Satın alma sistemi ve ödül yönetimi
|
||
* [🔥 **RemoteConfigService.md**](Documents/RemoteConfig/RemoteConfigService.md) → Firebase Remote Config entegrasyonu
|
||
* [📱 **FacebookService.md**](Documents/Facebook/FacebookService.md) → Facebook SDK kurulumu ve event takibi
|
||
* [🎯 **PopupService.md**](Documents/UI/PopupService.md) → Popup & UI animasyon sistemi
|
||
* [🎨 **ThemeService.md**](Documents/UI/ThemeService.md) → Tema yönetimi ve dinamik UI renk sistemi
|
||
* [🧰 **Editor Tools**](Documents/EditorTools/EditorTools.md) → SDK Configurator, PlayerPrefs Editor ve diğer editör araçları
|
||
---
|
||
|
||
## 🧩 **Desteklenen Unity Sürümü**
|
||
|
||
> Unity **6000.0.58f1**(test edilmiş).
|
||
---
|
||
|
||
**Hazırlayan:** Emir Han MAMAK
|
||
|
||
**Sürüm:** 2025.10
|
||
|
||
--- |