OsmAnd API, SDK - عينات

إذا كنت ترغب في استخدام OsmAnd كمكتبة لتطبيقك، فقد تفكر في استخدامه عبر SDK أو عبر API. حاليًا، هذه الخيارات متاحة فقط لنظام Android.

هناك طريقتان رئيسيتان لإعادة استخدام قوة OsmAnd في تطبيقك:

• Android OsmAnd AIDL API
• Android OsmAnd Full Library SDK

يتوفر كل الكود للعينتين في مستودع واحد.

أمثلة SDK

فيما يلي قائمة بأمثلة كيفية استخدام SDK داخل منتجك.

خريطة بسيطة - كيفية إضافة الخريطة إلى تطبيق بسيط.

Android OsmAnd AIDL API

المفهوم الرئيسي وراء هذا النهج هو أن التطبيق الهدف يتواصل مع OsmAnd عبر AIDL أو واجهة برمجة تطبيقات النوايا. يمتلك OsmAnd مجموعة غنية من الأساليب المدعومة واجهة AIDL. هناك العديد من التطبيقات التي تم بناؤها باستخدام هذا النهج والمفهوم الرئيسي هو أن التطبيق يحتوي على عدة شاشات وزر "الانتقال إلى الخريطة" خلف الكواليس، يقوم التطبيق بإعادة تكوين OsmAnd بالكامل ويوفر رد اتصال للعمليات الرئيسية مثل الملاحة، وتحديد موقع GPS، ويتضمن أيضًا عناصر واجهة المستخدم مثل الأدوات / أزرار الدرج، حتى يتمكن المستخدم من التنقل من الخريطة مرة أخرى إلى واجهة برمجة التطبيقات المستهدفة.

قائمة واجهات برمجة التطبيقات طويلة جدًا ويمكنك التعرف عليها داخل تطبيق العرض التوضيحي.

الإيجابيات

• لا توجد مشكلات في الترخيص - متاحة لجميع الأغراض الممكنة
• مدعومة دائمًا، ومُصدرة، ويتم صيانتها بواسطة فريق OsmAnd
• أسهل تكامل يتطلب أقل عدد من سطور الكود
• دائمًا لا تخلط منطق OsmAnd ومنطق عمل التطبيق
• أصغر حجم (2 ميجابايت)

السلبيات

• يتطلب تثبيت تطبيق OsmAnd بجانب تطبيقك
• عدد محدود من الأساليب مقارنة بنهج Full Library SDK
• قدرات محدودة للعلامة التجارية على الرغم من أنها يمكن أن تحتوي على شعار ذي علامة تجارية، وملفات تعريف ذات علامة تجارية، وأنماط خريطة، وما إلى ذلك في تطبيق OsmAnd
• لا يمكن تمرير الكود وعناصر واجهة المستخدم إلى OsmAnd، لذلك يمكن إجراء جميع التفاعلات فقط عن طريق تبديل الشاشات بين التطبيقات وردود الاتصال

يرجى التحقق من المثال على مستودع Github.

Android OsmAnd Full Library SDK

تُعيد مكتبة OsmAnd الكاملة استخدام OsmAnd بالكامل كمكتبة. بشكل أساسي، كل الكود / جميع أجزاء واجهة المستخدم هي جزء من هذه المكتبة مما يمنح الحرية في استخدام ما هو موجود بالفعل في OsmAnd ولكنه يتطلب فهمًا جيدًا لكيفية دمج عدة طبقات / خدمات.

الإيجابيات

• لا حاجة لتثبيت OsmAnd / OsmAnd+
• جميع الوظائف / الأساليب الممكنة من OsmAnd متاحة لإعادة الاستخدام
• لا يتطلب الكثير من الكود الخاص لبناء تطبيق غني

السلبيات

• لا يوجد توثيق كامل
• ترخيص كود صارم، تمامًا مثل كود OsmAnd نفسه
• واجهة برمجة التطبيقات التي تستخدم خوادم OsmAnd تتطلب موافقة مباشرة من فريق OsmAnd
• واجهة برمجة التطبيقات ليست مستقرة (لأنها ليست واجهة برمجة تطبيقات، إنها مكتبة داخلية بشكل أساسي)
• الحجم 70-150 ميجابايت (يمكن تقليصه عن طريق إزالة خريطة الأساس العالمية 20 ميجابايت). يمكن إجراء تلاعبات أخرى بالحجم بناءً على الغرض من التطبيق المستهدف.

يرجى التحقق من المثال على مستودع Github. تطبيق العرض التوضيحي OsmAnd-map-sample.apk.

الترخيص

قد ترغب في التحقق مرة أخرى من ترخيص OsmAnd و الإصدار الكامل.