شارك المقالة
مشاركة رابط في Flutter باستخدام share_plus

مشاركة رابط في Flutter باستخدام share_plus

مشاركة رابط في Flutter: flutter_share متوقفة وفق صفحة الناشر.

مشاركة رابط في Flutter تعني فتح نافذة المشاركة في النظام وترك المستخدم يختار التطبيق المستقبِل. الحزمة القديمة flutter_share تعلن توقف تطويرها في صفحة الناشر، ولذلك يستخدم المثال واجهة share_plus الحديثة: SharePlus.instance.share مع ShareParams. يبقى رابط هذه المقالة كما هو حتى تستمر الإشارات القديمة في الوصول إليها.

تجهيز الحزمة ومقارنة المتطلبات

أضف share_plus إلى المشروع وراجع متطلبات Flutter وDart وGradle وiOS في صفحة الإصدار الذي تختاره. اختُبر هذا المقطع مع share_plus 13.3.1؛ لا تغير أرقام الأدوات الأصلية في مشروع قائم عشوائيًا إذا كان الإصدار الجديد يحتاج ترقية بيئة البناء.

التحقق من الرابط قبل مشاركته

يقبل المثال رابط HTTP أو HTTPS مطلقًا ويرفض البروتوكولات الأخرى والروابط التي تحتوي بيانات اعتماد. هذا فحص للشكل فقط؛ لا يضمن أن الموقع آمن أو أن الصفحة متاحة. استخدم رابط المقال النهائي بدل رابط تحويل مختصر أو عنوان من لوحة الإدارة.

موضع نافذة المشاركة على iPad

مرر سياق زر المشاركة نفسه داخل Builder حتى يكون RenderBox المقاس هو الزر. يحسب المثال sharePositionOrigin من موضعه وحجمه. لا تستخدم سياق عنصر غير مبني أو مربع حجمه صفر؛ بعض واجهات المشاركة تحتاج مرساة واضحة على الأجهزة اللوحية.

النتيجة وحالات الإلغاء

انتظر Future وتعامل مع الاستثناء في الواجهة، وأعد تمكين الزر داخل finally. إغلاق نافذة المشاركة أو قبولها لا يثبت أن الرسالة قُرئت أو وصلت إلى شخص آخر؛ لا تضف عداد تحويلات أو مكافأة مالية اعتمادًا على هذه النتيجة وحدها.

الإعداد

flutter pub add share_plus

مثال تطبيقي

المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.

import 'package:flutter/material.dart';
import 'package:share_plus/share_plus.dart';

Uri checkedWebUri(String value) {
  final uri = Uri.tryParse(value.trim());
  if (uri == null || !['https', 'http'].contains(uri.scheme) || uri.host.isEmpty || uri.userInfo.isNotEmpty) {
    throw const FormatException('Expected a public HTTP(S) link');
  }
  return uri;
}

Future<ShareResult> shareArticle(BuildContext buttonContext, String value) {
  final uri = checkedWebUri(value);
  final render = buttonContext.findRenderObject();
  if (render is! RenderBox || !render.hasSize || render.size.isEmpty) {
    throw StateError('Share button has no layout');
  }
  return SharePlus.instance.share(ShareParams(
    text: uri.toString(),
    sharePositionOrigin: render.localToGlobal(Offset.zero) & render.size,
  ));
}

تطبيق مشاركة رابط في Flutter في مشروعك

flutter_share متوقفة وفق صفحة الناشر؛ استخدم SharePlus.instance.share مع ShareParams، وحدد موضع المشاركة عند الحاجة خصوصًا على iPad.

مراجع الموضوع: pub.dev — share_plus

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع