الدليل الشامل لتطوير تطبيقات فلاتر

التنقل للأمام

// الانتقال إلى صفحة جديدة
Navigator.push(
  context,
  MaterialPageRoute(builder: (context) => SecondScreen()),
);

// مع تمرير بيانات
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => ProductDetailsScreen(product: product),
  ),
);

الرجوع للخلف

// الرجوع إلى الصفحة السابقة
Navigator.pop(context);

// إرجاع قيمة
Navigator.pop(context, 'نتيجة من الصفحة الثانية');

استقبال نتائج من صفحة أخرى

// الانتقال وانتظار نتيجة
final result = await Navigator.push(
  context,
  MaterialPageRoute(builder: (context) => SelectItemScreen()),
);

if (result != null) {
  // معالجة النتيجة
  print('تم اختيار: $result');
}

تعريف المسارات

MaterialApp(
  // تعريف المسارات
  routes: {
    '/': (context) => HomeScreen(),
    '/details': (context) => DetailsScreen(),
    '/settings': (context) => SettingsScreen(),
    '/profile': (context) => ProfileScreen(),
  },
  initialRoute: '/', // المسار الابتدائي
);

استخدام المسارات المسماة

// الانتقال إلى مسار مسمى
Navigator.pushNamed(context, '/details');

// تمرير بيانات
Navigator.pushNamed(
  context, 
  '/details',
  arguments: {'id': 123, 'title': 'عنوان المنتج'},
);

// استقبال البيانات في الصفحة المستهدفة
final args = ModalRoute.of(context)!.settings.arguments as Map;
final id = args['id'];
final title = args['title'];

SQLite (مع sqflite)

قاعدة بيانات علائقية كاملة المزايا.

// تثبيت المكتبة في pubspec.yaml
// sqflite: ^2.0.2
// path: ^1.8.0

// إنشاء قاعدة البيانات والجدول
Future getDatabase() async {
  final dbPath = await getDatabasesPath();
  final path = join(dbPath, 'my_app.db');
  
  return openDatabase(
    path,
    onCreate: (db, version) {
      return db.execute(
        'CREATE TABLE users(id INTEGER PRIMARY KEY, name TEXT, age INTEGER)',
      );
    },
    version: 1,
  );
}

// إدخال بيانات
Future insertUser(User user) async {
  final db = await getDatabase();
  await db.insert(
    'users',
    user.toMap(),
    conflictAlgorithm: ConflictAlgorithm.replace,
  );
}

// قراءة البيانات
Future> getUsers() async {
  final db = await getDatabase();
  final List> maps = await db.query('users');
  
  return List.generate(maps.length, (i) {
    return User(
      id: maps[i]['id'],
      name: maps[i]['name'],
      age: maps[i]['age'],
    );
  });
}

// تثبيت المكتبة في pubspec.yaml
// path_provider: ^2.0.9

import 'dart:io';
import 'package:path_provider/path_provider.dart';

// الحصول على مسار الملف
Future get _localPath async {
  final directory = await getApplicationDocumentsDirectory();
  return directory.path;
}

// كتابة بيانات إلى ملف
Future writeToFile(String data) async {
  final path = await _localPath;
  final file = File('$path/data.txt');
  await file.writeAsString(data);
}

// قراءة بيانات من ملف
Future readFromFile() async {
  try {
    final path = await _localPath;
    final file = File('$path/data.txt');
    return await file.readAsString();
  } catch (e) {
    return '';
  }
}

// تثبيت المكتبة في pubspec.yaml
// http: ^0.13.4

import 'package:http/http.dart' as http;
import 'dart:convert';

// طلب GET
Future> fetchPosts() async {
  final response = await http.get(Uri.parse('https://jsonplaceholder.typicode.com/posts'));
  
  if (response.statusCode == 200) {
    final List data = jsonDecode(response.body);
    return data.map((json) => Post.fromJson(json)).toList();
  } else {
    throw Exception('فشل في تحميل المنشورات');
  }
}

// طلب POST
Future createPost(Post post) async {
  final response = await http.post(
    Uri.parse('https://jsonplaceholder.typicode.com/posts'),
    headers: {
      'Content-Type': 'application/json; charset=UTF-8',
    },
    body: jsonEncode(post.toJson()),
  );
  
  if (response.statusCode == 201) {
    return Post.fromJson(jsonDecode(response.body));
  } else {
    throw Exception('فشل في إنشاء المنشور');
  }
}

// نموذج البيانات
class Post {
  final int userId;
  final int? id;
  final String title;
  final String body;
  
  Post({required this.userId, this.id, required this.title, required this.body});
  
  factory Post.fromJson(Map json) {
    return Post(
      userId: json['userId'],
      id: json['id'],
      title: json['title'],
      body: json['body'],
    );
  }
  
  Map toJson() {
    return {
      'userId': userId,
      'title': title,
      'body': body,
    };
  }
}

// تثبيت المكتبة في pubspec.yaml
// dio: ^4.0.6

import 'package:dio/dio.dart';

class ApiService {
  final Dio _dio = Dio(BaseOptions(
    baseUrl: 'https://api.example.com',
    connectTimeout: 5000,
    receiveTimeout: 3000,
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
    },
  ));
  
  // إضافة معترض لتوكن التفويض
  void addAuthToken(String token) {
    _dio.interceptors.clear();
    _dio.interceptors.add(InterceptorsWrapper(
      onRequest: (options, handler) {
        options.headers['Authorization'] = 'Bearer $token';
        return handler.next(options);
      },
      onError: (DioError e, handler) {
        if (e.response?.statusCode == 401) {
          // تحديث التوكن أو تسجيل الخروج
        }
        return handler.next(e);
      },
    ));
  }
  
  // طلب GET
  Future> getUsers() async {
    try {
      final response = await _dio.get('/users');
      final List data = response.data;
      return data.map((json) => User.fromJson(json)).toList();
    } catch (e) {
      throw Exception('حدث خطأ: $e');
    }
  }
  
  // طلب POST
  Future createUser(User user) async {
    try {
      final response = await _dio.post('/users', data: user.toJson());
      return User.fromJson(response.data);
    } catch (e) {
      throw Exception('حدث خطأ: $e');
    }
  }
}

class PostsScreen extends StatefulWidget {
  @override
  _PostsScreenState createState() => _PostsScreenState();
}

class _PostsScreenState extends State {
  late Future> futurePosts;
  
  @override
  void initState() {
    super.initState();
    futurePosts = fetchPosts();
  }
  
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('المنشورات')),
      body: FutureBuilder>(
        future: futurePosts,
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Center(child: CircularProgressIndicator());
          } else if (snapshot.hasError) {
            return Center(child: Text('حدث خطأ: ${snapshot.error}'));
          } else if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return Center(child: Text('لا توجد منشورات'));
          } else {
            return ListView.builder(
              itemCount: snapshot.data!.length,
              itemBuilder: (context, index) {
                final post = snapshot.data![index];
                return ListTile(
                  title: Text(post.title),
                  subtitle: Text(post.body),
                );
              },
            );
          }
        },
      ),
    );
  }
}

// في ملف test/calculator_test.dart
import 'package:test/test.dart';
import 'package:my_app/calculator.dart';

void main() {
  group('Calculator', () {
    late Calculator calculator;
    
    setUp(() {
      calculator = Calculator();
    });
    
    test('يجب أن تجمع رقمين بشكل صحيح', () {
      expect(calculator.add(2, 3), 5);
    });
    
    test('يجب أن تطرح رقمين بشكل صحيح', () {
      expect(calculator.subtract(5, 2), 3);
    });
    
    test('يجب أن ترفع استثناء عند القسمة على صفر', () {
      expect(() => calculator.divide(10, 0), throwsA(isA()));
    });
  });
}

// في ملف test/counter_widget_test.dart
                                import 'package:flutter_test/flutter_test.dart';
import 'package:my_app/counter_widget.dart';

void main() {
  testWidgets('يجب أن يزيد العداد عند النقر', (WidgetTester tester) async {
    // بناء التطبيق وتشغيل دورة واحدة من الرسم
    await tester.pumpWidget(MaterialApp(
      home: CounterWidget(),
    ));

    // التحقق من وجود نص '0'
    expect(find.text('0'), findsOneWidget);
    expect(find.text('1'), findsNothing);

    // الضغط على زر الزيادة
    await tester.tap(find.byIcon(Icons.add));
    // انتظار انتهاء الرسوم المتحركة
    await tester.pump();

    // التحقق من تغير العداد إلى '1'
    expect(find.text('0'), findsNothing);
    expect(find.text('1'), findsOneWidget);
  });
}

// في ملف integration_test/app_test.dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:my_app/main.dart' as app;

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group('تطبيق كامل', () {
    testWidgets('التكامل المبسط', (WidgetTester tester) async {
      // تشغيل التطبيق
      app.main();
      await tester.pumpAndSettle();

      // التحقق من العناصر الأولية
      expect(find.text('العداد: 0'), findsOneWidget);

      // النقر على زر الزيادة
      await tester.tap(find.byIcon(Icons.add));
      await tester.pumpAndSettle();

      // التحقق من تحديث العداد
      expect(find.text('العداد: 1'), findsOneWidget);

      // الانتقال إلى صفحة جديدة
      await tester.tap(find.byType(ElevatedButton));
      await tester.pumpAndSettle();

      // التحقق من الصفحة الجديدة
      expect(find.text('الصفحة الثانية'), findsOneWidget);
    });
  });
}

متابعة وتحسين التطبيق

• جمع تعليقات المستخدمين والرد عليها
• متابعة تقارير الأعطال وإصلاحها
• دراسة تحليلات الاستخدام لتحسين تجربة المستخدم
• تحديث التطبيق بانتظام بميزات جديدة وإصلاحات
• تحسين تحسين متاجر التطبيقات (ASO) لزيادة الظهور