إعدادات

يمكن تحديد الإعدادات في أي تطبيق لاستخدامها في وقت التشغيل فقط أو حفظها لتستمر خلال جلسات العمل. يمكنك قراءة متغيرات بيئة المستخدم أو النظام أو ضبط متغيرات البيئة أو خصائصها أثناء وقت التشغيل أو حفظ الإعدادات في ملف.

متغيرات البيئة

يمكن تعيين متغيرات البيئة للمستخدم أو للنظام. يمكن تعيينها قبل تشغيل تطبيقك واستخدامها لتكوين سلوك تطبيق بديل. على سبيل المثال، إعداد متغير البيئة LANG سيؤثر على الإعدادات المحلية التي تستخدمها تطبيقات Qt.

لقراءة قيمة أي متغير بيئة في تطبيقك، استخدم AppFramework.environment.value().

لاستبدال إعداد متغير البيئة الحالي، استخدم AppFramework.environment.setValue(). سيظل هذا التغيير صالحًا أثناء تشغيل التطبيق.

PropertySet

PropertySet هو مكون يسمح لك بضبط أزواج قيم المفاتيح التي يمكن استخدامها في روابط QML. يُستخدم هذا المكون على أفضل وجه عندما لا تعلم كم ستكون قيمة الملكية قبل إطلاق التطبيق، ويتم ضبطه في وقت التشغيل بدلًا من ذلك.

لمزيد من المعلومات، راجع موضوع دليل إسناد API لمكون PropertySet.

ملف الإعدادات

يمكن حفظ الإعدادات في ملف JSON ويتم كتابة كليهما على مكون Settings ويُقرآن منه.

يتنوع موقع ملف JSON بحسب نظام التشغيل لديك، وكذلك ما إذا تم إنشاء التطبيق كتطبيق مستقل أو استخدامه من خلال AppRun أو AppStudio Player. في كل الحالات تقريبًا، لا حاجة إلى تحرير الملف، ولكن من الضروري فتح هذه الملفات لغرض اختبار الأخطاء. إذا أردت القيام بذلك، فإن الملفات توجد في المجلدات التالية، وتُسمّى بحسب UUID في ArcGIS Online:

• Windows: C:\Users\YourUsername\ArcGIS\AppStudio\Settings
• macOS و Ubuntu: ~\ArcGIS\AppStudio\Settings

بعد إنشاء التطبيق، يمكن إنشاء ملف الإعدادات المقصود في أحد المواقع القياسية الأربعة اعتمادًا على المعلومات المؤسسية في التطبيق وأذونات المستخدم. توجد مواقع احتياطية، ويمكنك تحديد ما إذا كان التطبيق سيستخدمها من خلال خاصية useFallbacks المنطقية.

حدد قيم الإعداد في ملف

يتم تعيين الإعدادات وتخزينها كأزواج قيم مفاتيح، وهي يتم استخدامها لتمثيل أي إعدادات أضفتها. إذا لم يكن المفتاح موجودًا، فإنه يمكن إنشاؤه لتعيين افتراضي أو لأي عنصر قام المستخدم بتعيينه له أولاً. تأكد من أن هذه القيم الأساسية حساسة لحالة الأحرف، واستخدم الأحرف الكبيرة دائمًا في كل الأحرف.

يدعم مكون Settings أربعة أنواع مختلفة من القيم التي قد تكون مفيدة في سياقات مختلفة. توضح الأمثلة التالية الطرق النموذجية التي قد يمكن استخدام القيم بها.

تُستَخدَم وظيفتي value و setValue الأساسيتين للسلاسل، ويمكن استخدامها لمجموعة متنوعة من السيناريوهات المختلفة. في هذه الحالة، توفر عينة الكود التالية طريقة لتعيين عنوان URL افتراضي للمسار:

readonly property string defaultLibraryPath: "~/ArcGIS/Example App/Library"

Item {
    Component.onDestruction: {
        var paths = libraryTextField.text.trim();

        if (paths.length <= 0) {
            paths = defaultLibraryPath;
        }

            settings.setValue("libraryPaths", paths, defaultLibraryPath);
    }

    TextField {
        id: libraryTextField

        Layout.fillWidth: true

        text: defaultLibraryPath
    }
}

توفر وظيفة boolValue خيار صواب أو خطأ، وهي مثالية لسؤال مغلق بفارق مطلوب بسيط. تُطبّق عينة الكود التالية الإعداد على مُبدّل، مما تحدد ما إذا كان المحتفظين بالتطبيق يسجلون الدخول عبر الجلسات:

property bool staySignedIn: false

    Switch {
    checked: staySignedIn
    onCheckedChanged: {
        staySignedIn = true;
        settings.boolValue("staySignedIn", true);
    }
}

يوفر مكون Settings أيضًا numberValue لتحديد عدد صحيح، ويعد مفيدًا للإعدادات متعددة المستويات، مثل الحجم أو السيناريوهات التي تتطلب اختيارًا بين خيارات متميزة عديدة، وكذلك colorValue التي تُخزّن قيمة لون سداسية تُستخدم بشكل كبير لتخصيص مظهر التطبيق. في حين أن هذه الوظائف تخزن أنواعًا مختلفة من القيم، فإنها تتصرف بنفس طريقة تصرُّف boolValue.