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

GitHub Repository

هيكل متكامل لـ Expo + React Native + Dodo Payments

نظرة عامة

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

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

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

البدء السريع

1

Clone the Repository

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

Get Your API Credentials

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

Configure Environment Variables

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

Install Dependencies

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

Start the Development Server

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

ما هو مدرج

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

Checkout Integration

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

Payment Handling

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

TypeScript Support

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

Expo Router

إعداد التنقل باستخدام Expo Router لتوجيه سلس

هيكل المشروع

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

Create Your Products

أضف المنتجات في لوحة تحكم Dodo Payments لتمكين وظيفة الخروج.
2

Customize the Integration

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

Test on Real Devices

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

Go Live

عند الاستعداد، قم بالتبديل إلى مفاتيح واجهة برمجة التطبيقات في الوضع الحي وأنشئ تطبيقك للإنتاج.

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

1

Install EAS CLI

npm install -g eas-cli
2

Configure EAS

eas build:configure
3

Build Your App

لنظام iOS:
eas build --platform ios
لـ Android:
eas build --platform android

موارد إضافية

الدعم

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