الانتقال إلى المحتوى الرئيسي

مستودع GitHub

نموذج إكسبو + React Native + مدفوعات دودي الكامل

نظرة عامة

نموذج جاهز للإنتاج لتكامل مدفوعات دودي في تطبيقات إكسبو/React Native. يتضمن هذا القالب إنشاء جلسات الدفع، معالجة المدفوعات، وتكوين TypeScript المناسب لمساعدتك في البدء بقبول المدفوعات في تطبيقك المحمول بسرعة.
يستخدم هذا النموذج SDK إكسبو مع TypeScript ويتضمن تنفيذات نموذجية لجلسات الدفع ومعالجة المدفوعات.

المتطلبات الأساسية

  • Node.js 18+
  • Expo CLI أو EAS CLI
  • حساب مدفوعات دودي (مفتاح API من لوحة التحكم)
  • محاكي iOS أو محاكي Android (أو جهاز فعلي)

البدء السريع

1

استنساخ المستودع

استنساخ مستودع النموذج والتنقل إلى دليل المشروع:
git clone https://github.com/dodopayments/expo-boilerplate.git
cd expo-boilerplate
2

احصل على بيانات اعتماد API الخاصة بك

احصل على بيانات اعتمادك من لوحة تحكم مدفوعات دودي في وضع الاختبار:
ابدأ بوضع الاختبار لاختبار تكاملاتك بأمان دون معالجة مدفوعات حقيقية.
3

تكوين متغيرات البيئة

قم بإنشاء ملف .env في الدليل الجذر:
touch .env
أضف بيانات اعتماد مدفوعات دودي الخاصة بك:
.env
EXPO_PUBLIC_DODO_API_KEY=your_test_api_key_here
لا تقم أبداً بإدخال ملف .env في التحكم في الإصدار. إنه مدرج بالفعل في .gitignore.
4

تثبيت التبعيات

قم بتثبيت حزم npm المطلوبة:
npm install
5

بدء خادم التطوير

ابدأ خادم تطوير إكسبو:
npx expo start
امسح رمز الاستجابة السريعة باستخدام تطبيق إكسبو جو على جهازك، أو اضغط على i لمحاكي iOS أو a لمحاكي Android.
أنت جاهز للبدء في البناء! يتضمن النموذج شاشات ومكونات نموذجية لمساعدتك في فهم التكامل.

ما هو مدرج

يأتي النموذج مع الأساسيات المكونة مسبقًا:

تكامل الدفع

تنفيذ نموذجي لإنشاء وإدارة جلسات الدفع

معالجة المدفوعات

تدفق دفع كامل مع معالجة النجاح والأخطاء

دعم TypeScript

تكوين TypeScript كامل مع تعريفات نوع مناسبة

موجه إكسبو

إعداد التنقل مع موجه إكسبو لتوجيه سلس

هيكل المشروع

expo-boilerplate/
├── app/
│   ├── (tabs)/
│   │   └── index.tsx          # Home screen with examples
│   └── checkout.tsx           # Checkout screen
├── components/
│   └── PaymentButton.tsx      # Payment button component
├── lib/
│   └── dodo.ts                # Dodo Payments client setup
├── .env.example               # Environment variables template
└── package.json

الخطوات التالية

بمجرد تشغيل النموذج:
1

إنشاء منتجاتك

أضف المنتجات في لوحة تحكم مدفوعات دودي لتمكين وظيفة الدفع.
2

تخصيص التكامل

قم بتكييف الكود النموذجي ليتناسب مع احتياجات وتصميم تطبيقك.
3

اختبار على الأجهزة الحقيقية

اختبر تدفق الدفع على الأجهزة الفعلية للتأكد من أن كل شيء يعمل بشكل صحيح.
4

الانتقال إلى الإنتاج

عند الاستعداد، قم بالتبديل إلى مفاتيح API في وضع الإنتاج وبناء تطبيقك للإنتاج.

البناء للإنتاج

1

تثبيت EAS CLI

npm install -g eas-cli
2

تكوين EAS

eas build:configure
3

بناء تطبيقك

لـ iOS:
eas build --platform ios
لـ Android:
eas build --platform android

موارد إضافية

الدعم

تحتاج إلى مساعدة بشأن النموذج؟