Hugging Face's logo

Spaces:
enzostvs
/
deepsite
Running

App Files Community
360
deepsite / GITHUB_SETUP_GUIDE.md
almortamoh's picture
almortamoh
Upload 36 files
a79063d verified
preview code
|
raw
history blame
5.9 kB

☁️ دليل إعداد البناء السحابي - GitHub Actions

🎯 الهدف: بناء APK تلقائياً في السحابة مجاناً!

📋 الخطوات المطلوبة:

الخطوة 1: إنشاء حساب GitHub ⏱️ (2 دقيقة)

  1. اذهب إلى: https://github.com
  2. اضغط "Sign up" وأنشئ حساب جديد
  3. تأكد من البريد الإلكتروني

الخطوة 2: إنشاء Repository جديد ⏱️ (1 دقيقة)

  1. اضغط "New repository" (الزر الأخضر)
  2. اسم المستودع: almada-unified-wallet
  3. الوصف: محفظتي الموحدة - تطبيق المحافظ الإلكترونية اليمنية
  4. اختر "Public" (مجاني)
  5. فعل "Add a README file"
  6. اضغط "Create repository"

الخطوة 3: رفع الملفات ⏱️ (5 دقائق)

الطريقة الأسهل: عبر الموقع

  1. في صفحة Repository، اضغط "uploading an existing file"
  2. اسحب وأفلت الملفات التالية:
    📁 .github/workflows/build-apk.yml
📄 index.html
📄 styles.css
📄 app.js
📄 auth.js
📄 wallets.js
📄 notifications.js
📄 demo.html
📄 package.json
📄 capacitor.config.ts
📄 .gitignore
📁 src/manifest.json
📁 android/ (كامل)
  3. اكتب رسالة: Initial commit - محفظتي الموحدة
  4. اضغط "Commit changes"

الطريقة المتقدمة: Git Command Line 

# في مجلد المشروع
git init
git add .
git commit -m "Initial commit - محفظتي الموحدة"
git branch -M main
git remote add origin https://github.com/USERNAME/almada-unified-wallet.git
git push -u origin main

الخطوة 4: تشغيل البناء التلقائي ⏱️ (10-15 دقيقة)

  1. اذهب إلى تبويب "Actions" في Repository
  2. ستجد workflow اسمه: 🚀 Build APK - محفظتي الموحدة
  3. اضغط "Run workflow" إذا لم يبدأ تلقائياً
  4. انتظر اكتمال البناء (10-15 دقيقة)

الخطوة 5: تحميل APK ⏱️ (1 دقيقة)

عند اكتمال البناء:

  1. اضغط على Build الناجح (علامة ✅ خضراء)
  2. في الأسفل، ستجد "Artifacts"
  3. اضغط على: almada-unified-wallet-apk
  4. حمل ملف ZIP واستخرج APK منه

🎯 البدائل السحابية الأخرى:

Ionic Appflow (مجاني للمشاريع الصغيرة): 

# تثبيت Ionic CLI
npm install -g @ionic/cli

# تسجيل الدخول
ionic login

# ربط المشروع
ionic link

# بناء في السحابة
ionic capacitor build android --prod

CodeMagic (مجاني 500 دقيقة/شهر):

  1. اذهب إلى: https://codemagic.io
  2. ربط حساب GitHub
  3. اختر Repository
  4. إعداد workflow للأندرويد
  5. بناء تلقائي

📱 ما ستحصل عليه:

من GitHub Actions:

  • ✅ بناء تلقائي عند كل تحديث
  • ✅ APK مجاني بدون حدود
  • ✅ تاريخ الإصدارات كامل
  • ✅ رابط تحميل مباشر

معلومات APK:

  • 📱 الاسم: app-debug.apk
  • 💾 الحجم: ~15-20 MB
  • 🔧 النوع: Debug APK
  • 📲 جاهز للتثبيت على أي هاتف أندرويد

🔄 التحديثات المستقبلية:

لإضافة ميزات جديدة:

  1. عدل الملفات في Repository
  2. Commit التغييرات
  3. APK جديد سيُبنى تلقائياً!

لإنشاء Release: 

# إنشاء tag جديد
git tag v1.0.1
git push origin v1.0.1

# سيُنشئ Release تلقائياً مع APK

🆘 حل المشاكل:

مشكلة: Build فشل 

الحل:
1. تحقق من logs في Actions
2. تأكد من رفع جميع الملفات
3. تحقق من package.json

مشكلة: لا يوجد Artifacts 

الحل:
1. تأكد من نجاح Build (علامة ✅)
2. انتظر اكتمال جميع الخطوات
3. حدث الصفحة

مشكلة: APK لا يعمل 

الحل:
1. تأكد من تفعيل "مصادر غير معروفة"
2. تحقق من توافق إصدار الأندرويد
3. أعد تحميل APK

💡 نصائح مهمة:

للنجاح:

  • 📁 ارفع جميع الملفات المطلوبة
  • 🌐 تأكد من اتصال الإنترنت أثناء البناء
  • ⏰ انتظر اكتمال جميع الخطوات

للأمان:

  • 🔒 لا تشارك معلومات حساسة في Repository العام
  • 🔑 استخدم Secrets للمعلومات الحساسة
  • 🛡️ راجع الأذونات بانتظام

للتطوير:

  • 📝 اكتب وصف واضح للـ commits
  • 🏷️ استخدم tags للإصدارات
  • 📚 حدث README بانتظام

🎉 النتيجة النهائية:

عند اكتمال هذه الخطوات، ستحصل على:

  • ☁️ نظام بناء سحابي مجاني
  • 🔄 APK تلقائي عند كل تحديث
  • 📱 رابط تحميل مباشر
  • 🌍 متاح للعالم عبر GitHub

📞 تحتاج مساعدة؟

إذا واجهت أي مشكلة:

  1. راجع logs في GitHub Actions
  2. تحقق من الملفات المرفوعة
  3. تواصل للمساعدة

🚀 مبروك! تطبيقك سيُبنى في السحابة!

💡 ملاحظة: GitHub Actions مجاني للمشاريع العامة مع 2000 دقيقة/شهر للمشاريع الخاصة.