> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Örnek uygulama: SDK kurulumu ve kullanıcı kimliği

> Clean Beans örnek uygulamasının OneSignal SDK'sını Expo'ya nasıl kurduğu, her cihazı External ID ile bir kullanıcıya nasıl bağladığı ve e-postayı nasıl eklediği.

Bu sayfa, gerçek bir uygulamayı baştan sona takip eden [Örnek uygulama: eksiksiz bir OneSignal entegrasyonu](https://documentation.onesignal.com/docs/tr/example-full-integration-overview.md) kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan **Clean Beans**'tir ve Expo (React Native) ile bir Supabase backend'i kullanılarak geliştirilmiştir.

Diğer her şey dört şeyin doğru olmasına bağlıdır: SDK kuruludur, uygulama başladığında SDK da başlar, her cihaz bir kullanıcıya bağlıdır ve kişiler ne alacaklarını kontrol edebilir.

## Expo eklentisiyle kurulum \\

`onesignal-expo-plugin`, yerel iOS ve Android projelerini derleme sırasında yapılandırır. OneSignal'ın görseller, rozetler ve teslimat onayı için ihtiyaç duyduğu push capability'sini, App Group'u ve Notification Service Extension'ı ekler.

```json app.json theme={null}
{
  "expo": {
    "plugins": [
      ["onesignal-expo-plugin", { "mode": "production" }],
      "expo-router",
      "./plugins/withLiveActivityWidget"
    ],
    "ios": {
      "bundleIdentifier": "com.onesignal.cleaningapp",
      "infoPlist": {
        "UIBackgroundModes": ["remote-notification"],
        "NSSupportsLiveActivities": true
      },
      "entitlements": {
        "aps-environment": "production",
        "com.apple.security.application-groups": [
          "group.com.onesignal.cleaningapp.onesignal"
        ]
      }
    }
  }
}
```

## Kökte bir kez başlatın \\

Clean Beans, OneSignal'ı kök düzeninde başlatır. Böylece her açılışta, herhangi bir ekran görünmeden önce bir kez çalışır.

```typescript app/_layout.tsx theme={null}
// Verbose logging is for debugging during the beta. Remove it, or lower
// the level, before a public release.
OneSignal.Debug.setLogLevel(LogLevel.Verbose);
OneSignal.initialize('YOUR_ONESIGNAL_APP_ID');
OneSignal.Notifications.requestPermission(true);
```

> [!TIP]
>
> İlk açılışta izin istemek en basit yaklaşımdır. Önce faydayı açıklamak için sistem isteminden önce bir uygulama içi mesaj gösterin. Clean Beans'te hazır bir tane var: [Push izni ön istemi](https://documentation.onesignal.com/docs/tr/example-full-integration-in-app-messages.md#push-permission-pre-prompt) bölümüne bakın.

## Her cihazı bir kullanıcıya bağlayın \\

Biri oturum açtığında uygulama, Supabase kullanıcı kimliğini `OneSignal.login()` fonksiyonuna iletir. Bu kimlik External ID olur. Kullanıcı oturumu kapattığında `logout()` cihazın bağlantısını keser. Böylece oturum açan bir sonraki kişi önceki kullanıcının mesajlarını devralmaz.

```typescript app/_layout.tsx theme={null}
// Link OneSignal identity to authenticated user and sync timezone
//
// Wait until the saved session has been restored. On a cold start `user`
// is null for a moment while it loads; calling logout() then, followed by
// login() a moment later, can leave this device's push subscription on an
// anonymous OneSignal user, so pushes sent to the External ID never reach
// the phone. logout() is only called on a real sign-out.
const wasSignedIn = useRef(false);
useEffect(() => {
  if (loading) return;

  if (user) {
    wasSignedIn.current = true;
    OneSignal.login(user.id);
    syncDeviceTimezone();
    // Add email subscription and sync data tags to OneSignal
    if (user.email) syncOneSignalEmail(user.email);
    // Add the SMS subscription if the user has a verified phone number
    syncOneSignalSms();
    syncOneSignalTags();
  } else if (wasSignedIn.current) {
    wasSignedIn.current = false;
    OneSignal.logout();
  }
}, [user, loading]);
```

> [!WARNING]
>
> İki yöntemden herhangi birini çağırmadan önce kayıtlı oturumun yüklenmesini bekleyin. Soğuk başlatmada oturum açmış kullanıcı kısa bir süre bilinmez. Uygulama o anda `logout()` ve hemen ardından `login()` çağırırsa, cihazın push aboneliği anonim bir kullanıcıda kalabilir ve External ID'ye gönderilen push'lar telefona ulaşmaz. `logout()` yöntemini yalnızca biri gerçekten oturumu kapattığında çağırın.

Bu kılavuzdaki her backend gönderimini mümkün kılan bu tek çağrıdır. Bir kullanıcının veritabanı kimliğini bilen bir fonksiyon, cihazları hakkında hiçbir şey bilmeden ona mesaj gönderebilir.

## E-posta kanalını ekleyin \\

Uygulama, her kullanıcının e-posta adresini kayıttan beri bilir. Bu yüzden oturum açıldığında adresi bir e-posta aboneliği olarak kaydeder. OneSignal aynı adresle yapılan tekrar çağrılarını yok sayar.

```typescript src/lib/onesignalSync.ts theme={null}
export function syncOneSignalEmail(email: string): void {
  try {
    if (!email) return;
    OneSignal.User.addEmail(email);
    console.log('[onesignalSync] Email subscription added');
  } catch (e) {
    console.warn('[onesignalSync] syncOneSignalEmail error:', e);
  }
}
```

SMS de aynı şekilde `addSms()` ile eklenir, ancak yalnızca numara doğrulandıktan sonra. [SMS: doğrulama kodları ve davetler](https://documentation.onesignal.com/docs/tr/example-full-integration-sms.md) sayfasına bakın.

## Kişilerin ne alacaklarını kontrol etmesine izin verin \\

Bildirim ayarları ekranında bir ana anahtar ve her mesaj türü için bir anahtar bulunur.

![Ana anahtarı ve türe göre anahtarları olan bildirim ayarları ekranı](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-notifications.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=57fef32f8987a51e7bdf8c40a6273087)

Bildirim ayarları: ana anahtar, türe göre anahtarlar ve günlük hatırlatıcı saati.

Ana anahtar, push aboneliğinde `optOut()` ve `optIn()` çağırır. Böylece OneSignal o cihaza teslimatı durdurur ve yeniden başlatır.

```typescript app/notification-settings.tsx theme={null}
const handlePushMasterToggle = async (enabled: boolean) => {
  try {
    if (enabled) {
      OneSignal.User.pushSubscription.optIn();
    } else {
      OneSignal.User.pushSubscription.optOut();
    }
  } catch (e) {
    console.warn('OneSignal subscription toggle failed:', e);
  }
  save({ ...prefs, pushEnabled: enabled });
};
```

Her anahtar, kullanıcının profil satırına da kaydedilir. Backend bir şey göndermeden önce bu sütunları okur. Türe göre tercihler bu şekilde uygulanır.

```typescript src/lib/database.ts theme={null}
  const { error } = await supabase
    .from('profiles')
    .update({
      notifications_enabled: prefs.pushEnabled,
      push_daily_reminders: prefs.pushDailyReminders,
      push_streak_reminders: prefs.pushStreakReminders,
      push_cleaning_done: prefs.pushCleaningDone,
      push_leaderboard_updates: prefs.pushLeaderboardUpdates,
      push_upcoming_cleaning: prefs.pushUpcomingCleaning,
      push_overdue_reminders: prefs.pushOverdueReminders,
      email_weekly_summary: prefs.emailWeeklySummary,
      notification_hour: prefs.notificationHour,
      timezone: prefs.timezone,
    })
    .eq('id', user.id);
```

> [!NOTE]
>
> Tercihleri kendi veritabanınızda saklamak ve her gönderimden önce kontrol etmek, mantığı tek bir yerde tutar. Alternatif, tercihleri etiket olarak saklamak ve OneSignal'da etikete göre filtrelemektir. Bu yöntem segmentlere gönderim yaptığınızda iyi çalışır. Clean Beans belirli kullanıcılara gönderim yaptığı için veritabanını kontrol etmek daha basittir.

> [card] [Mobil SDK referansı](https://documentation.onesignal.com/docs/tr/mobile-sdk-reference.md)
>
> Bu kılavuzda kullanılan tüm istemci yöntemleri.

> [card] [Kullanıcılar ve External ID'ler](https://documentation.onesignal.com/docs/tr/users.md)
>
> Kimliğin abonelikleri kanallar ve cihazlar arasında nasıl bağladığı.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.