فيما يلي السلوكيات التي قد تواجهك عند استخدام AppStudio الذي يتمتع بحلول بديلة أو إجراءات معروفة يمكنك تنفيذها لحل المشكلات.
للإبلاغ عن الأخطاء أو معرفة المزيد عنها في AppStudio، تفضل بزيارة الدعم.
التثبيت والإعداد
- عند النقر مرتين على ملف Linux في .run، يتم تحميل Ubuntu Software Center وأتلقى رسالة خطأ. لماذا؟
- فشل تشغيل ArcGIS AppStudio، وتظهر رسالة خطأ تفيد بأن ملف api-ms-win-crt-runtime-l1-1-0.dll مفقود.
- لا يعمل ArcGIS AppStudio في مساحة العمل الخاصة بي، ولكنه يعمل خارج الموقع.
- لا تتلقى وحدة تحكم AppStudio سجلات وحدة التحكم.
- تطبيق ArcGIS Runtime يتعطل على نظام Windows.
- لا يمكنني إنشاء جهاز Android ظاهري لاختبار التطبيق الخاص بي.
- لقد قمتُ بتثبيت Android Studio، ولكن لم يتعرف AppStudio عليه.
- يتم نطق تحويل النص إلى حديث بالعربية في iOS 14.
- فشل تطبيق AppStudio الإصدار 5.0 في البدء على Ubuntu.
- يظهر مربع حوار AppStudio كشاشة بيضاء على Ubuntu 22.04.
تكوين التطبيقات ونشرها
- لن يعمل تطبيق Quick Report الموجود الخاص بي وسيعرض رسالة الخطأ "Cannot assign to non-existing property onComposeError" (يتعذر التعيين إلى خاصية onComposeError غير موجودة).
- لا يمكنني تحديد طبقة مشهد في تطبيق قالب 3D Scene Viewer.
- تفشل استعلامات SQL الخاصة بي، حيث تفيد إما أن جدول قاعدة البيانات مؤمن الآن، أو أن الاتصال لا يزال قيد الاستخدام.
- طرق AppFramework.SecureStorage value و setValue تُرجع الخطأ التالي في تطبيقي على macOS: اسم المستخدم أو عبارة المرور التي أدخلتها غير صحيحة.
- يعمل تطبيقي بشكل غير متوقع عند تشغيل لوحة مفاتيح SwiftKey على Android.
- عند تمرير apiKey خاطئ إلى خرائط من النوع TiledLayer أو VectorTiledLayer، تظهر الخريطة ولكن بنمط غير متوقع.
إنشاء ملفات التثبيت
- لا يمكنني إنشاء التطبيق لـ iOS بدون تقديم شهادة.
- تم استلام رسالة خطأ الإصدار Provisioning profile "ABC" has an app ID "com.abc.xyz", which does not match the bundle ID "com.xyz.abc".
- تم استلام رسالة خطأ الإصدار Provisioning profile is not an "ABC" profile.
- تم استلام رسالة خطأ الإصدار Code signing error: Provisioning profile "ABC" doesnt include signing certificate "DEF".
- تم استلام رسالة خطأ الإصدار Code signing error: Provisioning profile "ABC" doesnt support the Associated Domains capability.
- تم استلام رسالة خطأ الإصدار Invalid Android signing parameters.
الإرسال للمتجر
التثبيت والإعداد
تشير هذه الرسالة إلى أن Universal C Runtime في مكونات Windows، والمطلوبة لتشغيل AppStudio، مفقود. تم توزيع هذه المكونات في تحديث Windows الذي يمكن تنزيله من دعم Windows.
السبب المرجح لذلك هو أن مساحة العمل تتحكم في الوصول إلى الإنترنت من خلال برنامج التكوين النصي الآلي المستند إلى قاعدة. لم يُكتشف حاليًا هذا النموذج من البروكسي بواسطة AppStudioAppStudio، مما يعني أنه قد تتأثر قدرة اتصال التطبيق بـ ArcGIS Online. في هذه الحالة، قد يتعين عليك إيقاف تشغيل برنامج التكوين النصي وتكوين خادم البروكسي يدويًا من خلال مجموعة من العنوان والمنفذ.
من Windows، يمكن العثور على الخيارات التي تتحكم في ذلك في إعدادات شبكة المنطقة المحلية (LAN) في خيارات الإنترنت.
من المحتمل أن يكون ذلك بسبب تصفية رسائل برتوكول مخطط بيانات المستخدم (UDP) التي تعرضها وحدة التحكم أو حظرها بواسطة جدار الحماية. ويمكن إصلاح ذلك بواسطة إما إيقاف تشغيل جدار الحماية أو السماح باستثناءات حزم UDP لمدة استخدام أداة وحدة التحكم. يمكنك أيضًا، من أجل شبكة موثوقة بشكل أكبر، إعادة تعيين جدار الحماية للسماح لحزم UDP عند تحدِّيه.
ومن المرجح أن يرجع ذلك إلى فشل برنامج تشغيل الرسومات على جهاز Windows لتلبية الحد الأدنى من المتطلبات. يعد OpenGL 2.1 الحد الأدنى من متطلبات عروض الخريطة ثنائية الأبعاد عند تشغيل تطبيقات ArcGIS Runtime، كما يعد الإصدار 3.2 الحد الأدنى من متطلبات عروض المشهد ثلاثي الأبعاد. يُوصَى باستخدام أحدث برنامج تشغيل متاح.
إذا كنت تستخدم أجهزة ظاهرية لاستخدام التطبيق الخاص بك على العديد من الأنظمة الأساسية، لا يمكنك تشغيل أجهزة محاكاة Android عليها. هذا لأن أجهزة تقليد Android تستخدم مدير تنفيذ الأجهزة السريعة (HAXM)، ومحرك التصور الذي لا يدعم الأجهزة الظاهرية المتداخلة. لا يمكنك إلا تشغيل جهاز محاكاة Android على جهاز حقيقي.
يبحث AppStudio مبدئيًا عن الملفات في موقع Android Studio الافتراضي. إذا تم تكوين موقع Android SDK في Qt Creator، فسيستخدم AppStudio ذلك كبديل.
المسارات الافتراضية إلى SDK لكل نظام أساسي يكون على النحو التالي:
- Windows: Users/YourName/AppData/Local/Android/sdk
- macOS: ~/Library/Android/sdk
- Linux: ~/Android/Sdk
الملفات المستخدمة لتعبئة قائمة الجهاز الظاهري، يجب أن تقع في المجلدات التالية:
- عملية تكوين AVD تكون للقراءة من الدلائل الفرعية أسفل ~/.android.
- يتم قراءة رمز المصادقة لجهاز التقليد من ~/.emulator_console_auth_token.
- مسار الأمر adb يكون <SDKPATH>/platform-tools/adb.
- مسار أمر جهاز التقليد يكون <SDKPATH>/tools/emulator.
على الأجهزة التي تعمل بنظام iOS 14 أو الأحدث، لا تتوفر جميع أصوات تحويل النص إلى حديث على الجهاز بشكل افتراضي. نتيجة لذلك، عند قراءة التنبيهات، قد تُسمع لغة غير متوقعة، وتكون عادة بالعربية.
يمكن تنزيل ملفات الصوت يدويًا على الجهاز. للتنزيل، انتقل إلى الإعدادات > إمكانية الوصول > تركيب الصوت > الحديث > الصوت وقم بتنزيل أحد الأصوات التي تطابق لغة الجهاز. يمكنك العثور على لغة الجهاز بالضغط على الإعدادات > إعدادات عامة > اللغة والمنطقة > لغة iPhone
في المرة القادمة عند تشغيل AppStudio Player أو التطبيق الذي تم إنشائه، سيستخدم جهاز التنزيل.
لضمان عرض مربع الحوار تسجيل الدخول على هذا الإصدار من Ubuntu، يجب تعيين المتغير البيئي QTWEBENGINE_DISABLE_SANDBOX إلى 1. لتعيين هذا المتغير البيئي، في نافذة المحطة الطرفية، شغّل export QTWEBENGINE_DISABLE_SANDBOX=1. لتأكيد تعيين ذلك المتغير البيئي، شغّل printenv | grep QTWEBENGINE_DISABLE_SANDBOX والتأكد من إرجاع QTWEBENGINE_DISABLE_SANDBOX=1.
تكوين التطبيقات ونشرها
تفشل استعلامات SQL الخاصة بي، حيث تفيد إما أن جدول قاعدة البيانات مؤمن الآن، أو أن الاتصال لا يزال قيد الاستخدام.
هذان خطآن منفصلان يحدثان عند بدء استعلام ثانٍ باستخدام مكون AppFramework.SQLQuery، قبل إكمال الاستعلام الأول. يمكن تجنب هذه الأخطاء باستخدام طريقة finish لإعلام التطبيق بأن أي نتائج متبقية من الاستعلام الأول ليست مطلوبة، أو عن طريق التأكد من طلب جميع النتائج من خلال الاستدعاءات التكرارية لطريقة next.
طرق AppFramework.SecureStorage value و setValue تُرجع الخطأ التالي في تطبيقي على macOS: اسم المستخدم أو عبارة المرور التي أدخلتها غير صحيحة.
يجب توقيع التطبيق المصمم لـ macOS والذي يستخدم الوحدات النمطية SecureStorage و ArcGIS Runtime للوصول إلى سلسلة مفاتيح النظام. لمعرفة المزيد، راجع موضوع سجل الدخول إلى التطبيق macOS.
إنشاء ملفات التثبيت
وبخلاف الأنظمة الأساسية الأخرى، تتطلب تطبيقات iOS شهادة إنتاج موقعة قبل إنشائها، حتى لأغراض الاختبار. يحدث خطأ عند محاولة إنشاء واحد دون آخر. للحصول على معلومات حول الحصول على هذه الشهادات والحفاظ عليها، راجع موضوع الحفاظ على توقيع الأصول في دليل توزيع تطبيق Apple. يجب عليك أيضًا تعيين مُعرف حزمة مناسب للتطبيق، الذي يتم عن طريق فتح نافذة الإعدادات في لوحة AppStudio الجانبية، واستعراض علامة تبويب iOS أسفل عنوان الأنظمة الأساسية. لمعرفة المزيد، راجع موضوع سجل الدخول إلى التطبيق iOS.
تم استلام رسالة خطأ الإصدار Code signing error: Provisioning profile "ABC" doesnt support the Associated Domains capability.
يشير هذا الخطأ إلى أن التطبيق يعرف الرابط إلى التطبيق للاستخدام بواسطة التطبيقات الأخرى، غير المسجلة في developers.apple.com. لمعرفة المزيد، راجع وثائق Apple في السماح للتطبيقات ومواقع الويب بالارتباط بالمحتوى.
ربما يتم استلام الخطأ إذا كنت تحاول إنشاء التطبيق على جهاز غير الذي تمت عليه المحاولات السابقة. لم يتم حفظ ملف KeyStore في عنصر التطبيق، ويتم حفظ إشارة إلى موقعه في العنصر. للتحقق من توفر إمكانية الوصول إلى ملف KeyStore الصحيح، انتقل إلى الإعدادات > النظام الأساسي > Android وتأكد من المسار إلى ملف KeyStore والاسم المستعار للمفتاح صحيحين.
الإرسال للمتجر
سبب هذا الخطأ إما وجود وحدات بكسل شفافة أو قناة ألفا في رمز التطبيق. قم بإزالة ذلك من الرمز وأعد إنشاء ملفات تثبيت التطبيق وأعد الإرسال إلى المتجر. ينطبق هذا القيد على iOS App Store. يُسمح بالشفافية في رموز التطبيق على أنظمة أساسية أخرى. يمكنك تحديد رموز التطبيق الخاصة بالنظام الأساسي عن طريق تحرير ملف appinfo.json في مشروعك. في AppStudio، حدد التطبيق من المعرض وانقر فوق تحرير. اختر ملف appinfo.json وحرر عنصر resources لتضمين خصائص appIcon لكل نظام أساسي، كالمثال التالي:"resources": {
"android": {
"appIcon": "assets/android_appicon.png"
},
"ios": {
"appIcon": "assets/ios_appicon.png"
},
"linux": {
"appIcon": "linux_appicon.png"
},
"macos": {
"appIcon": "mac_appicon.png"
},
"windows": {
"appIcon": "windows_appicon.png"
},
"appIcon": "allNotSpecifiedOperatingSystems_appicon.png"
},
عند إنشاء إدخال متجر تطبيقات، يجب تحديد معرف فريد للتطبيق. يكون هذا المعرف عادة بتنسيق com.yourdomain.appname. تأكد من إدخال المعرف نفسه في الإعدادات > النظام الأساسي > Android أو الإعدادات > النظام الأساسي > iOS. بعد إدخال المعرف الفريد، تأكد من النقر فوق تطبيق وقم بتحميل التطبيق إلى مؤسسة ArcGIS قبل أن تطلب إصدارًا.