شرح Tawakkalna Flutter SDK لتطوير Mini Apps والتكامل مع تطبيق توكلنا
في ظل التحول الرقمي السريع الذي تشهده المملكة العربية السعودية، أصبحت التطبيقات الحكومية الذكية جزءًا أساسيًا من الحياة اليومية للمواطنين والمقيمين. ومن أبرز هذه التطبيقات يأتي تطبيق توكلنا كمنصة مركزية تجمع العديد من الخدمات الحكومية في مكان واحد. ومع تطور هذه المنصة، ظهر مفهوم Mini Apps داخل توكلنا، مما فتح الباب أمام المطورين لبناء تطبيقات متكاملة تعمل داخل هذه البيئة.
وهنا يأتي دور Tawakkalna Flutter SDK، الذي يُعد أداة مهمة لمطوري Flutter تمكنهم من تطوير تطبيقات مصغرة (Mini Apps) والتكامل مع خدمات توكلنا بسهولة ومرونة.
في هذا المقال سنتعرف على هذه المكتبة، أهم مميزاتها، كيفية استخدامها، وأفضل حالات استخدامها في المشاريع الحقيقية.
ما هو تطبيق توكلنا ولماذا هو مهم؟
من خلال التطبيق يمكن للمستخدمين:
– الوصول إلى الخدمات الحكومية بشكل مركزي – إدارة الهوية الرقمية والوثائق الرسمية – متابعة الحالة الصحية والتطعيمات – الاطلاع على بيانات المركبات والمخالفات – الوصول إلى العنوان الوطني وبيانات الأسرة
ويأتي هذا ضمن رؤية السعودية 2030 التي تهدف إلى رقمنة الخدمات وتسهيل الوصول إليها عبر الأجهزة الذكية.
ومع توسع المنصة، أصبح من الممكن تطوير تطبيقات مصغرة داخل توكلنا، مما زاد من أهمية وجود أدوات مثل Tawakkalna Flutter SDK.
ما هي مكتبة Tawakkalna Flutter SDK؟
تعتمد المكتبة على إنشاء جسر (Bridge) بين:
– Dart (داخل Flutter) – JavaScript APIs الخاصة بتوكلنا
وبذلك تتيح للمطورين الوصول إلى بيانات المستخدم والخدمات الحكومية بسهولة من داخل تطبيق Flutter.
كما تدعم المكتبة:
– بيئة اختبار (Mock Environment) – Flutter Web – النشر داخل تطبيق توكلنا
تنبيه مهم: هذه المكتبة غير رسمية ومفتوحة المصدر، ولم يتم اعتمادها رسميًا من قبل الجهات الحكومية.
لماذا تحتاج إلى Tawakkalna Flutter SDK؟
– التحقق من الهوية – عرض الوثائق الرسمية – الوصول إلى بيانات المركبات – التعامل مع الخدمات الحكومية
ولكن تنفيذ هذا التكامل بشكل مباشر قد يكون معقدًا، وهنا توفر Tawakkalna Flutter SDK حلاً جاهزًا يسهل هذه العملية.
فبدلاً من بناء تكامل معقد، يمكنك استخدام واجهات جاهزة في Dart تتصل مباشرة مع JavaScript APIs الخاصة بتوكلنا.
أهم مميزات Tawakkalna Flutter SDK
الوصول إلى بيانات المستخدم
مثل الاسم، الهوية، العائلة، والمعلومات الشخصية.
عرض الوثائق الرسمية
مثل الهوية الوطنية أو الإقامة.
بيانات المركبات والمخالفات
إمكانية عرض معلومات المركبات والغرامات.
البيانات الصحية والتعليمية
الوصول إلى السجلات المرتبطة بالمستخدم.
الموقع والعنوان الوطني
استخدام بيانات الموقع الرسمية داخل التطبيقات.
إدارة الأذونات
التحكم في الصلاحيات التي يمنحها المستخدم.
دعم QR وBarcode
لإنشاء تجارب تفاعلية داخل التطبيقات.
بيئة تطوير مرنة
إمكانية الاختبار قبل النشر داخل توكلنا.
كيفية تثبيت المكتبة
dependencies:
tawakkalna_sdk_flutter: ^0.0.5-alpha.5
ثم قم بتنفيذ:
flutter pub get
إعداد Flutter Web للعمل مع Mini Apps
للتطوير والاختبار:
<script src="assets/packages/tawakkalna_sdk_flutter/assets/web/twkhelper_mock.js"></script>
للإنتاج داخل توكلنا:
<script src="assets/packages/tawakkalna_sdk_flutter/assets/web/twkhelper.js"></script>
هذا الجسر هو ما يسمح لتطبيق Flutter بالتواصل مع بيئة توكلنا.
كيف يعمل التكامل بين Flutter وتوكلنا؟
– يتم إرسال الطلب من Flutter (Dart) – يتم تحويله إلى JavaScript – يتم التواصل مع APIs الخاصة بتوكلنا – يتم إرجاع البيانات إلى Flutter
هذا يجعل العملية تبدو للمطور وكأنه يتعامل مع API عادي داخل Flutter.
أفضل حالات استخدام Tawakkalna Flutter SDK
بناء خدمات رقمية متكاملة داخل بيئة توكلنا.
تطبيقات الشركات
مثل التأمين، العقارات، والخدمات اللوجستية التي تحتاج التحقق من الهوية.
الخدمات الصحية
الوصول إلى السجلات الصحية للمستخدم.
التعليم
عرض البيانات التعليمية داخل تطبيقات موحدة.
التكاملات المالية
استخدام بيانات الهوية لتسهيل عمليات الدفع والتحقق.
نصائح مهمة عند استخدام Tawakkalna Flutter SDK
تأكد من طلب الصلاحيات اللازمة من المستخدم.
اختبر باستخدام Mock Environment
لتجنب المشاكل أثناء التطوير.
احرص على الأمان
تعامل مع البيانات الحساسة بحذر.
تابع تحديثات المكتبة
لأنها غير رسمية وقد تتغير باستمرار.
رابط المكتبة
https://pub.dev/packages/tawakkalna_sdk_flutter
رابط المقال
https://pub.dev/packages/tawakkalna_sdk_flutter
الخلاصة
من خلال هذه المكتبة، يمكنك الوصول إلى بيانات المستخدم والخدمات الحكومية وتقديم تجارب متكاملة داخل تطبيق واحد، مما يفتح آفاقًا جديدة لتطوير التطبيقات داخل المملكة العربية السعودية.
ورغم أن المكتبة غير رسمية، إلا أنها تمثل فرصة قوية للمطورين لاستكشاف إمكانيات التكامل مع توكلنا وبناء حلول مبتكرة تدعم التحول الرقمي.
إذا كنت تعمل على مشروع يستهدف المستخدمين داخل السعودية، فإن تجربة Tawakkalna Flutter SDK قد تكون خطوة مهمة نحو بناء تطبيق أكثر ذكاءً وتكاملاً.
لمزيد من المقالات : أفضل مكتبة لإنشاء Flutter Animated Bottom Navigation متحرك (تجربة UI مذهلة)






