flutter_login_vk

flutter_login_vk

مسند رفرفة لتسجيل الدخول عبر vk.com.

إضافة ميزة تسجيل الدخول VK بسهولة في التطبيق الخاص بك. معلومات ملف تعريف المستخدم المضمّن.

نسخة SDK

إصدار VK SDK ، يستخدم في البرنامج المساعد:

• iOS: ^1.6 (Cocoapods)

• Android: 3.5.0 (Maven Core ، API)

الحد الأدنى من المتطلبات

• iOS 9.0 وأعلى.

• Android 5.0 وأحدث (SDK 21 ). الحد الأدنى compileSdkVersion 31 .

️ إذا تم إنشاء مشروعك باستخدام Flutter Pre 1.12 ، فيجب عليك ترقيته إلى Android Serbding V2. انظر https://flutter.dev/go/android-project-migration

ابدء

لاستخدام هذا البرنامج المساعد:

1. أضف flutter_login_vk كاعتماد في ملف pubspec.yaml الخاص بك ؛

2. قم بإنشاء تطبيق على vk.com

3. إعداد Android ؛

4. إعداد iOS ؛

5. إعداد تطبيق VK.com إضافي ؛

6. استخدم البرنامج المساعد في التطبيق.

انظر الوثائق على vk.com للحصول على معلومات كاملة:

• iOS SDK

• Android SDK

وهنا تعليمات باللغة الروسية إذا كانت لغتك الأصلية (рсекаиии).

تطبيق على vk.com

قم بإنشاء تطبيق على vk.com https://vk.com/editapp؟act=create

1. أدخل "العنوان".

2. حدد التطبيق المستقل كـ "منصة".

3. انقر فوق "توصيل التطبيق".

سيتم إنشاء تطبيق. الآن حدد علامة التبويب "إعدادات" ونسخ "معرف التطبيق" (المشار إليها باسم [APP_ID] في هذا ReadMe).

إعدادات التطبيق لنظام Android

1. تعيين Package name for Android - اسم الحزمة الخاص بك لتطبيق Android ( package السمات في AndroidManifest.xml ).

2. اضبط Main activity for Android - فئة النشاط الرئيسية الخاصة بك (مع الحزمة). بشكل افتراضي ، سيكون com.yourcompany.yourapp.MainActivity .

3. لملء Signing certificate fingerprint for Android يجب إنشاء بصمة SHA1 كما هو موضح في الوثائق (بدون SHA1: بادئة). انتبه : يجب عليك إزالة جميع الكولون من سلسلة بصمات الأصابع. أضف بصمات الأصابع لشهادات التصحيح والإصدار. ملاحظة: إذا كان التطبيق الخاص بك يستخدم توقيع تطبيق Google Play مما يجب عليك الحصول على شهادة SHA-1 بصمة من Google Play Console.

   ️ مهم! يجب عليك إضافة بصمات الأصابع لكل متغيرات البناء. على سبيل المثال ، إذا كان لديك CI/CD الذي يقوم ببناء APK للاختبار باستخدام شهادة خاصة به (قد يتم إنشاء شهادة تصحيح تلقائيًا أو بعضها البعض) مما يجب عليك إضافة بصمة الإصبع أيضًا.

4. انقر فوق "حفظ".

إعدادات التطبيق لنظام التشغيل iOS

1. أضف معرف الحزمة الخاص بك - تعيين App Bundle ID for iOS (يمكنك العثور عليه في XCode: Runner - Target Runner - General ، Identity ، Bundle Identifier الحقل).

2. قم أيضًا بتعيين App ID for iOS ، إنه أنت SKU (يمكنك العثور عليه في App Store Connect: تطبيقاتي - {Application} - متجر التطبيق - معلومات التطبيق ، القسم "المعلومات العامة"). في الغالب ليس هو نفسه معرف الحزمة.

3. انقر فوق "حفظ".

Android

تحرير AndroidManifest.xml ( android/app/src/main/AndroidManifest.xml ):

1. أضف إذن INTERNET في جذر <manifest> ، إذا لم تكن لديك (ربما لديك):

 <use-parrishing android: name = "Android.permission.internet" />

2. أضف نشاطًا إلى application القسم:

 <النشاط Android: name = "com.vk.sdk.vkserviceActivity" Android: label = "serviceActivity" Android: theme = "@style /vk.transparent" />

3. أضف معرف تطبيق VK الخاص بك إلى ملف المورد (على سبيل المثال strings.xml ) ، استبدال [APP_ID] بمعرف التطبيق الخاص بك:

 <sourges>
    <integer name = "com_vk_sdk_appid"> [app_id] </integer>
</الموارد>

4. إضافة قواعد -keep class com.vk.** { *; } في ملف proguard الخاص بك ( android/app/proguard-rules.pro ).

انظر الكامل AndroidManifest.xml في المثال.

iOS

تكوين Info.plist ( ios/Runner/Info.plist ). يمكنك تحريره كملف نصي من IDE الخاص بك ، أو يمكنك فتح Project ( ios/Runner.xcworkspace ) في XCode.

1. في Xcode انقر بزر الماوس الأيمن على Info.plist ، واختر Open As Source Code .

2. انسخ والصق مقتطف XML التالي في جسم ملفك ( <dict>...</dict> ) ، استبدال [APP_ID] بمعرف التطبيق الخاص بك:

 <key> cfbundleurltypes </key>
<array>
  <dict>
  <key> cfbundleurlschemes </key>
  <array>
    <string> vk [app_id] </string>
  </ray>
  </dict>
</ray>

3. أضف أيضًا إلى Info.plist body ( <dict>...</dict> ):

 <key> lsapplicationQueriessChemes </key>
 <array>
     <string> vk </string>
     <string> vk-share </string>
     <string> vkauthorize </string>
 </ray>

4. أدخل معرف تطبيق VK الخاص بك.

 <key> vkappid </key>
<string> [app_id] </string>

انظر Info.plist كاملة.

️ ملحوظة. تحقق مما إذا كان لديك بالفعل مفاتيح CFBundleURLTypes أو مفاتيح LSApplicationQueriesSchemes في Info.plist . إذا كان لديك ، فيجب عليك دمج قيمها ، بدلاً من إضافة مفتاح مكرر.

إذا كنت ترغب في استخدام scope=nohttps ، وهو ما لا نوصي به بقوة ، فيجب عليك أيضًا إضافة NSAppTransportSecurity ، راجع الوثائق.

إعداد تطبيق VK.com إضافي

انتقل إلى تطبيقاتي وانقر فوق "إدارة" على تطبيقك.

في علامة التبويب "معلومات" يجب عليك:

1. أدخل "الوصف".

2. حدد "فئة" مناسبة.

3. تحميل أيقونة صغيرة "32x32 أيقونة".

4. انقر فوق "حفظ".

5. قم بتحميل "Banner Square" و "لافتة مربعة لـ Catalog" - يمكن للمستخدم رؤيته.

قم بإعداد إعدادات أخرى إذا كنت في حاجة إليها.

من الانتقال إلى علامة التبويب "Setting" وقم بتشغيل التطبيق: قم بتغيير "حالة التطبيق" من Application off إلى Application on and visible to all .

انقر فوق "حفظ".

الاستخدام في التطبيق

أولاً ، يجب عليك إنشاء مثيل VKLogin . من قبل ، قبل أي طريقة اتصل أو التحقق من accessToken ، يجب عليك تهيئة VK SDK:

 Final Vk = vklogin () ؛ await vk.initsdk () ؛

الآن يمكنك استخدام البرنامج المساعد.

سمات:

• تسجيل الدخول عبر vk.com ؛

• احصل على رمز الوصول ؛

• احصل على ملف تعريف المستخدم ؛

• احصل على بريد إلكتروني للمستخدم ؛

• تحقق مما إذا كان تسجيل الدخول ؛

• تسجيل الخروج.

نموذج الرمز:

 استيراد 'الحزمة: flutter_login_vk/flutter_login_vk.dart' ؛ // إنشاء مثيل vkloginfinal vk = vklogin () ؛ // initializeawait vk.initsdk () ؛ // log infinal res = await ، vkscope.friends ،
]) ؛ // تحقق من النتائج (res.isvalue) {// لا يوجد خطأ ، لكننا لا نعرف بعد
  // إذا قام المستخدم بتسجيل الدخول أم لا.
  // يجب عليك التحقق من iscanceled
  نتيجة VkloginResult النهائية = res.asvalue! .value ؛  if (result.iscanceled) {// المستخدم إلغاء تسجيل الدخول
  } آخر {// تسجيل الدخول // إرسال رمز الوصول إلى الخادم للتحقق من صحة و authfinal vkaccessToken؟ AccessToken = result.AccessToken ؛ if (AccessToken! = null) {print ('Access Token: $ {AccessToken.Token}') ؛      // الحصول على ملفات تعريف profileres النهائية = Await vk.getuserProfile () ؛      الملف الشخصي النهائي = profileres.asvalue؟ .value ؛      if (profile! = null) {print ('hello ، $ {profile.firstName}! you id: $ {profile.userid}') ؛
      } // احصل على البريد الإلكتروني (لأننا نطلب أذونات البريد الإلكتروني) البريد الإلكتروني النهائي = await vk.getuseremail () ؛      طباعة ("والبريد الإلكتروني الخاص بك هو $ البريد الإلكتروني") ؛
    } آخر {print ('something somether ") ؛
    }
  }
} آخر {// فشل الدخول
  errores النهائي = res.Aserror! ؛  print ('خطأ أثناء تسجيل الدخول: $ {errorres.error}') ؛
}

ملاحظات التهيئة

عند الاتصال initSdk() ، حاول البرنامج المساعد لاستعادة الجلسة السابقة. إذا تم انتهاء صلاحية الرمز المميز - فسيتم تحديثه.

أيضًا ، أثناء الاستعادة ، قد يتم عرض شاشة تسجيل الدخول للمستخدم (فقط إذا تم تسجيل الدخول إلى المستخدم).

بشكل إضافي ، يمكنك الانتقال إلى scope initSdk() المطلوب ، وإذا لم توفر جلسة المستخدم الحالية - سيتم تسجيل المستخدم.

كما يمكنك تحديد إصدار API للاستخدام ، ولكن لا ينبغي عليك ذلك.