يعرض لك هذا المشروع كيفية تنفيذ قطعة بسيطة من Glassware تعرض الوظائف الرئيسية لواجهة برمجة تطبيقات Google Mirror.
للاطلاع على عرض توضيحي كامل عن مشروع البدء السريع، انتقل إلى https://glass-python-starter-demo.appspot.com. وإلا، تابع القراءة لمعرفة كيفية نشر إصدارك الخاص.
المتطلبات الأساسية
تأكد من أن النظام الخاص بك يلبي المتطلبات الأساسية التالية لمشروع البدء السريع:
- جافا الإصدار 1.6
- Apache Maven - يُستخدم كجزء من عملية الإنشاء.
إنشاء مشروع وحدة تحكم Google APIs
بعد ذلك، يجب تفعيل الوصول إلى Google Mirror API:
- انتقل إلى وحدة تحكم Google APIs وأنشئ مشروع واجهة برمجة تطبيقات جديدًا.
- انقر على الخدمات وفعِّل Google Mirror API لمشروعك الجديد.
- انقر على الوصول إلى واجهة برمجة التطبيقات وأنشئ معرِّف عميل OAuth 2.0 لتطبيق ويب.
- حدد اسم المنتج ورمزه لـ Glassware. تظهر هذه الحقول على شاشة منح OAuth الإذن المقدمة للمستخدمين.
- اختَر تطبيق ويب وحدِّد أي قيمة لاسم المضيف، مثل
localhost
- انقر على تعديل الإعدادات... لمعرِّف العميل لتحديد معرِّفات الموارد المنتظمة (URI) لإعادة التوجيه. حدد عناوين URL لرد الاتصال على خادم الويب للتطوير المحلي، على سبيل المثال
http://localhost:8080/oauth2callback
، وخادم الويب المنشور، على سبيل المثالhttps://example.com/oauth2callback
. - دوّن معرّف وسر العميل من وحدة تحكم Google APIs. ستحتاج إليه لإعداد مشروع البدء السريع.
تهيئة مشروع البدء السريع
يمكنك إعداد مشروع البدء السريع لاستخدام معلومات عميل واجهة برمجة التطبيقات عن طريق إدخال معرِّف العميل والرمز السرّي في src/main/resources/oauth.properties
:
# Replace these with values for your project from the Google API Console:
# https://developers.google.com/console
client_id=3141592653589793238462643383279
client_secret=ITS_A_SECRET_TO_EVERYBODY
استيراد المشروع
توضح لك التعليمات التالية استيراد مصدر مشروع البدء السريع إلى IntelliJ وEclipse.
IntelliJ
- انقر على ملف > استيراد المشروع....
- أشِر إلى الدليل المُستخرج.
- حدد الاستيراد من النموذج الحالي > Maven
الكسوف
- ثبِّت المكوّن الإضافي
m2e
لتفعيل الاستيراد من ملف maven pom. - انقر على ملف > استيراد... > Maven > مشروع Maven الحالي.
- أشِر إلى الدليل المُستخرج واستخرِج المشروع.
تشغيل خادم تطوير محلي
يمكنك تشغيل مشروع البدء السريع على خادم تطوير محلي للاختبار:
$ mvn jetty:run
نشر مشروع البدء السريع
يمكنك إنشاء ملف حرب لهذا المشروع باستخدام Maven:
$ mvn war:war