أتمتة بناء APK ورفعه إلى Slack عبر واجهات الرفع الخارجية، مع حراسة الأسرار وفصل اختبارات pull request عن نشر النسخ.
افصل التحقق عن التوزيع
دع pull_request يشغّل التحليل والاختبارات دون خطوة توزيع تعتمد أسرارًا. قيّد رفع APK بحدث push إلى فرع موثوق أو environment محمي، ولا تستخدم pull_request_target لبناء كود غير موثوق مع رمز Slack. اضبط permissions على الحد اللازم، وثبت مراجعات Actions التي تعتمدها، ولا تطبع رمز البوت أو رابط رفع مؤقت في السجلات.
نجاح HTTP لا يساوي نجاح Slack
تدفق الرفع الخارجي يطلب رابط رفع ثم يرسل الملف ثم يكمل الرفع ويشارك الملف للقناة. افحص الحقل ok ووجود file_id في كل مرحلة مناسبة، وفشل الطلب أو نفاد المهلة. دع المسؤول يدعو البوت للقناة المطلوبة بدل توسيع صلاحياته للانضمام العام بلا حاجة. اختبر APK الموقع على جهاز اختبار وتأكد من إصدار وتوقيع ملفك قبل توزيعه.
خطوات التطبيق والشرح
شرح رفع APK إلى Slack باستخدام GitHub Actions في Flutter Flutter
المشكلة التي نريد حلها
- تعمل Push على GitHub
- تبني التطبيق يدويًا
- تدور على ملف APK
- ترفعه على Slack
- تبلغ الفريق إن فيه نسخة جديدة
الحل باستخدام GitHub Actions
dev، GitHub Actions هيبدأ يشغل خطوات البناء، وبعد ما يخلص هيتم رفع ملف APK مباشرة إلى Slack.لماذا نستخدم CI/CD مع Flutter؟
- تسريع دورة التطوير
- تقليل الأخطاء البشرية
- تنفيذ نفس خطوات البناء في بيئة نظيفة كل مرة
- إرسال النسخ الجديدة للفريق تلقائيًا
- سهولة التوسع لاحقًا ورفع التطبيق إلى Google Play أو TestFlight
المتطلبات الأساسية قبل البدء
- مشروع Flutter يعمل بشكل سليم
- مستودع GitHub يحتوي على الكود
- حساب Slack Workspace
- Slack Bot Token
- Channel ID للقناة التي سيتم رفع APK عليها
- إضافة Secrets داخل GitHub Repository
التأكد من بناء تطبيق Flutter محليًا
flutter build apk --release
build/app/outputs/apk/release/app-release.apk
إعداد GitHub Secrets
Settings → Secrets and variables → Actions → New repository secret
SLACK_BOT_TOKEN: توكن البوت الخاص بـ SlackSLACK_CHANNEL_ID: رقم القناة التي سيتم رفع الملف إليها
الصلاحيات المطلوبة من Slack Bot
files:writeلرفع الملفاتchannels:readلقراءة بيانات القنواتchannels:joinللانضمام إلى القنوات العامة
إنشاء ملف GitHub Actions Workflow
.github/workflows/build.yaml
كود GitHub Actions كامل لبناء APK ورفعه إلى Slack
name: Flutter
on:
push:
branches: [ "dev" ]
pull_request:
branches: [ "dev" ]
env:
FLUTTER_VERSION: '3.32.0'
JAVA_VERSION: '17.x'
BUILD_TYPE: 'release'
jobs:
build_android:
name: Build & Deploy Android
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Java
uses: actions/setup-java@v3
with:
java-version: ${{ env.JAVA_VERSION }}
distribution: 'adopt'
- name: Setup Flutter
uses: subosito/flutter-action@v2.21.0
with:
channel: 'stable'
flutter-version: ${{ env.FLUTTER_VERSION }}
- name: Check Flutter Version
run: flutter --version
- name: Install dependencies
run: flutter pub get
- name: Build APK
run: flutter build apk --release
- name: Join Slack channel public
if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
env:
SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
SLACK_CHANNEL_ID: ${{ secrets.SLACK_CHANNEL_ID }}
run: |
set -e
RESP=$(curl -sS -X POST \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-type: application/json; charset=utf-8" \
--data "{\"channel\":\"$SLACK_CHANNEL_ID\"}" \
https://slack.com/api/conversations.join)
echo "$RESP"
command -v jq >/dev/null 2>&1 && echo "$RESP" | jq -e '(.ok == true) or (.error == "already_in_channel")' > /dev/null
- name: Upload APK to Slack v2 API
if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
env:
SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
SLACK_CHANNEL_ID: ${{ secrets.SLACK_CHANNEL_ID }}
APK_PATH: build/app/outputs/apk/release/app-release.apk
run: |
set -e
[ -f "$APK_PATH" ] || { echo "APK not found at $APK_PATH"; ls -R build/app/outputs || true; exit 1; }
BASENAME="$(basename "$APK_PATH")"
SIZE=$(stat -c%s "$APK_PATH" 2>/dev/null || wc -c < "$APK_PATH")
COMMENT=$(printf "🚀 New Android build\n• Commit: %s" "$GITHUB_SHA")
GET_RESP=$(curl -sS -X POST https://slack.com/api/files.getUploadURLExternal \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-type: application/x-www-form-urlencoded" \
--data "filename=${BASENAME}&length=${SIZE}")
printf '%s\n' "$GET_RESP" | jq -e '(.ok == true) and (.file_id != null)' > /dev/null
UPLOAD_URL=$(printf '%s\n' "$GET_RESP" | jq -e '(.ok == true) and (.file_id != null)' > /dev/null | jq -r '.upload_url')
FILE_ID=$(printf '%s\n' "$GET_RESP" | jq -e '(.ok == true) and (.file_id != null)' > /dev/null | jq -r '.file_id')
[ -n "$UPLOAD_URL" ] && [ "$UPLOAD_URL" != "null" ] || { echo "Failed to get upload_url"; exit 1; }
curl -sS -X POST -F "file=@${APK_PATH}" "$UPLOAD_URL" >/dev/null
BODY=$(jq -n --arg fid "$FILE_ID" --arg title "$BASENAME" --arg ch "$SLACK_CHANNEL_ID" --arg c "$COMMENT" \
'{files:[{id:$fid,title:$title}], channel_id:$ch, initial_comment:$c}')
curl -sS -X POST https://slack.com/api/files.completeUploadExternal \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-type: application/json" \
-d "$BODY" | tee /tmp/slack_complete.json
jq -e '.ok == true' /tmp/slack_complete.json > /dev/null
شرح ملف Workflow خطوة بخطوة
build.yaml.تحديد اسم Workflow
name: Flutter
تشغيل Workflow عند Push أو Pull Request
on:
push:
branches: [ "dev" ]
pull_request:
branches: [ "dev" ]
dev. لو عايز تشغله على فرع main، غير dev إلى main.تحديد نسخة Flutter وJava
env:
FLUTTER_VERSION: '3.32.0'
JAVA_VERSION: '17.x'
BUILD_TYPE: 'release'
FLUTTER_VERSION: نسخة Flutter المطلوبةJAVA_VERSION: نسخة Java المستخدمة في البناءBUILD_TYPE: نوع البناء، وفي المثال Release
اختيار نظام التشغيل
runs-on: ubuntu-latest
استنساخ الكود من المستودع
- uses: actions/checkout@v4
إعداد Java
- name: Setup Java
uses: actions/setup-java@v3
with:
java-version: ${{ env.JAVA_VERSION }}
distribution: 'adopt'
إعداد Flutter
- name: Setup Flutter
uses: subosito/flutter-action@v2.21.0
with:
channel: 'stable'
flutter-version: ${{ env.FLUTTER_VERSION }}
تثبيت Dependencies
- name: Install dependencies
run: flutter pub get
flutter pub get بيقوم بتحميل الحزم الموجودة داخل ملف pubspec.yaml.بناء ملف APK
- name: Build APK
run: flutter build apk --release
build/app/outputs/apk/release/app-release.apk
الانضمام إلى قناة Slack
- name: Join Slack channel public
if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
env:
SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
SLACK_CHANNEL_ID: ${{ secrets.SLACK_CHANNEL_ID }}
run: |
set -e
RESP=$(curl -sS -X POST \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-type: application/json; charset=utf-8" \
--data "{\"channel\":\"$SLACK_CHANNEL_ID\"}" \
https://slack.com/api/conversations.join)
echo "$RESP"
command -v jq >/dev/null 2>&1 && echo "$RESP" | jq -e '(.ok == true) or (.error == "already_in_channel")' > /dev/null
https://slack.com/api/conversations.join
ok == truealready_in_channel
رفع ملف APK إلى Slack
- الحصول على Upload URL
- رفع الملف إلى الرابط المؤقت
- إكمال عملية الرفع ونشر الملف داخل القناة
التأكد من وجود ملف APK
[ -f "$APK_PATH" ] || { echo "APK not found at $APK_PATH"; ls -R build/app/outputs || true; exit 1; }
الحصول على Upload URL
GET_RESP=$(curl -sS -X POST https://slack.com/api/files.getUploadURLExternal \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-type: application/x-www-form-urlencoded" \
--data "filename=${BASENAME}&length=${SIZE}")
upload_url: الرابط الذي سيتم رفع الملف عليهfile_id: رقم الملف داخل Slack
رفع ملف APK
curl -sS -X POST -F "file=@${APK_PATH}" "$UPLOAD_URL" >/dev/null
إكمال الرفع وإرسال الملف للقناة
curl -sS -X POST https://slack.com/api/files.completeUploadExternal \
-H "Authorization: Bearer $SLACK_BOT_TOKEN" \
-H "Content-type: application/json" \
-d "$BODY" | tee /tmp/slack_complete.json
files.completeUploadExternal حتى يظهر الملف داخل قناة Slack مع التعليق المطلوب.إضافة تعليق مع رقم Commit
COMMENT=$(printf "🚀 New Android build\n• Commit: %s" "$GITHUB_SHA")
مشكلة jq في GitHub Actions
jq لمعالجة JSON داخل الـ Shell.
غالبًا jq تكون موجودة بالفعل داخل ubuntu-latest. لكن لو ظهرت لك مشكلة إن jq غير مثبتة، أضف الخطوة التالية قبل رفع الملف:- name: Install jq
run: sudo apt-get update && sudo apt-get install -y jq
ملاحظات مهمة عند استخدام Slack API
- تأكد إن البوت لديه صلاحية رفع الملفات
- تأكد إن
SLACK_CHANNEL_IDصحيح وليس اسم القناة - لو القناة Private، قم بدعوة البوت يدويًا
- لا تكتب Slack Token مباشرة داخل ملف YAML
- استخدم GitHub Secrets دائمًا لحماية البيانات الحساسة
مشاكل شائعة وحلولها
APK not found
APK not found at build/app/outputs/apk/release/app-release.apk
not_in_channel
- لو القناة Public، استخدم
conversations.join - لو القناة Private، قم بدعوة البوت يدويًا
invalid_auth
missing_scope
files:write
channels:read
channels:join
هل يمكن بناء AAB بدل APK؟
flutter build appbundle --release
build/app/outputs/bundle/release/app-release.aab
APK_PATH إلى مسار ملف AAB.أفضل الممارسات الأمنية
- لا تضع أي Token داخل الكود مباشرة
- استخدم GitHub Secrets للبيانات الحساسة
- استخدم أقل صلاحيات ممكنة للبوت
- راجع صلاحيات Slack App بشكل دوري
- لا تشارك ملف Keystore داخل المستودع
مميزات هذا الحل
- بناء APK تلقائيًا عند كل Push
- توفير وقت الفريق
- تقليل الأخطاء اليدوية
- ربط عملية التطوير مباشرة مع Slack
- سهولة معرفة رقم Commit الخاص بكل نسخة
- إمكانية التوسع لاحقًا لإضافة اختبارات أو نشر على المتاجر
الخلاصة
مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.






