الميزات وواجهات برمجة التطبيقات

يقدّم Android 17 ميزات وواجهات برمجة تطبيقات جديدة ورائعة للمطوّرين. توضّح الأقسام التالية هذه الميزات لمساعدتك على البدء في استخدام واجهات برمجة التطبيقات ذات الصلة.

للحصول على قائمة مفصّلة بواجهات برمجة التطبيقات الجديدة والمعدَّلة والمحذوفة، يُرجى الاطّلاع على تقرير الاختلافات في واجهات برمجة التطبيقات. للحصول على تفاصيل حول واجهات برمجة التطبيقات الجديدة، يُرجى الانتقال إلى مرجع واجهات برمجة تطبيقات Android، حيث يتم تمييز واجهات برمجة التطبيقات الجديدة لتسهيل العثور عليها.

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

الوظيفة الأساسية

يضيف نظام التشغيل Android 17 الميزات الجديدة التالية ذات الصلة بوظائف Android الأساسية.

عوامل تشغيل ProfilingManager الجديدة

Android 17 向 ProfilingManager 添加了多个新的系统触发器，可帮助您收集深入的数据来调试性能问题。

新增的触发条件包括：

TRIGGER_TYPE_COLD_START：触发器在应用冷启动期间触发。它会在响应中同时提供调用堆栈样本和系统轨迹。
TRIGGER_TYPE_OOM：当应用抛出 OutOfMemoryError 并提供 Java 堆转储作为响应时，会触发此事件。
TRIGGER_TYPE_KILL_EXCESSIVE_CPU_USAGE：当应用因 CPU 使用率异常过高而被终止时，系统会触发此事件，并提供调用堆栈样本作为响应。

如需了解如何设置系统触发器，请参阅有关基于触发器的分析以及如何检索和分析分析数据的文档。

واجهات برمجة التطبيقات JobDebugInfo

يقدّم الإصدار 17 من Android واجهات برمجة تطبيقات JobDebugInfo جديدة لمساعدة المطوّرين في تصحيح أخطاء مهام JobScheduler، مثل سبب عدم تنفيذها ومدة تنفيذها وغيرها من المعلومات المجمّعة.

الطريقة الأولى من واجهات برمجة التطبيقات الموسّعة JobDebugInfo هي getPendingJobReasonStats()، والتي تعرض خريطة للأسباب التي أدّت إلى بقاء المهمة في حالة التنفيذ المعلّق ومدة التنفيذ المعلّق التراكمية لكل سبب. تنضم هذه الطريقة إلى الطريقتَين getPendingJobReasonsHistory() وgetPendingJobReasons() لتزويدك بمعلومات حول سبب عدم تنفيذ مهمة مجدولة على النحو المتوقّع، ولكنّها تبسّط عملية استرداد المعلومات من خلال إتاحة كلّ من المدة وسبب المهمة في طريقة واحدة.

على سبيل المثال، بالنسبة إلى jobId محدّد، قد تعرض الطريقة PENDING_JOB_REASON_CONSTRAINT_CHARGING ومدة 60000 ملي ثانية، ما يشير إلى أنّ المهمة كانت في انتظار التنفيذ لمدة 60000 ملي ثانية بسبب عدم استيفاء شرط الشحن.

الخصوصية

يتضمّن نظام التشغيل Android 17 الميزات الجديدة التالية لتحسين خصوصية المستخدمين.

أداة اختيار جهات الاتصال على Android

أداة اختيار جهات الاتصال في Android هي واجهة موحّدة يمكن للمستخدمين تصفّحها لمشاركة جهات الاتصال مع تطبيقك. وتتوفّر هذه الأداة على الأجهزة التي تعمل بالإصدار Android 17 أو الإصدارات الأحدث، وهي تقدّم بديلاً يحافظ على الخصوصية للإذن الواسع النطاق READ_CONTACTS. بدلاً من طلب الوصول إلى دفتر العناوين الكامل للمستخدم، يحدّد تطبيقك حقول البيانات التي يحتاجها، مثل أرقام الهواتف أو عناوين البريد الإلكتروني، ويختار المستخدم جهات اتصال معيّنة لمشاركتها. يمنح هذا الإذن تطبيقك إذن الوصول للقراءة إلى البيانات المحدّدة فقط، ما يضمن التحكّم الدقيق مع توفير تجربة مستخدم متّسقة تتضمّن ميزات البحث المضمّن والتبديل بين الملفات الشخصية والاختيار المتعدّد بدون الحاجة إلى إنشاء واجهة المستخدم أو صيانتها.

لمزيد من المعلومات، اطّلِع على مستندات أداة اختيار جهات الاتصال.

الأمان

يضيف نظام التشغيل Android 17 الميزات الجديدة التالية لتحسين أمان الأجهزة والتطبيقات.

وضع "الحماية المتقدّمة على Android" (AAPM)

يوفّر "وضع الحماية المتقدّمة" على Android مجموعة جديدة وفعّالة من ميزات الأمان لمستخدمي Android، ما يمثّل خطوة مهمة في حماية المستخدمين، لا سيما المعرّضين لخطر أكبر، من الهجمات المتطورة. تم تصميم "إدارة التطبيقات تلقائيًا" كميزة اختيارية، ويتم تفعيلها من خلال إعداد واحد يمكن للمستخدمين تفعيله في أي وقت لتطبيق مجموعة من إجراءات الحماية الأمنية.

تشمل هذه الإعدادات الأساسية حظر تثبيت التطبيقات من مصادر غير معروفة (التثبيت الجانبي) وتقييد إشارات بيانات USB وفرض عمليات الفحص التي تجريها خدمة "Google Play للحماية"، ما يقلّل بشكل كبير من مساحة سطح الاختراق على الجهاز. يمكن للمطوّرين الاستفادة من هذه الميزة باستخدام واجهة برمجة التطبيقات AdvancedProtectionManager لرصد حالة الوضع، ما يتيح للتطبيقات اعتماد وضع أمان محسّن تلقائيًا أو حظر الوظائف العالية الخطورة عندما يوافق المستخدم على تفعيل الوضع.

إمكانية الاتصال

يضيف نظام التشغيل Android 17 الميزات التالية لتحسين إمكانية اتصال الأجهزة والتطبيقات.

شبكات الأقمار الصناعية ذات النطاق الترددي المحدود

实现优化，使应用能够在低带宽卫星网络上有效运行。

تجربة المستخدم وواجهة مستخدم النظام

يتضمّن نظام التشغيل Android 17 التغييرات التالية لتحسين تجربة المستخدم.

النقل

‫Handoff هي ميزة وواجهة برمجة تطبيقات جديدة ستتوفّر في Android 17، ويمكن لمطوّري التطبيقات دمجها لتوفير تجربة متواصلة للمستخدمين على جميع الأجهزة. تتيح هذه الميزة للمستخدم بدء نشاط تطبيق على أحد أجهزة Android ونقله إلى جهاز Android آخر. تعمل ميزة Handoff في خلفية جهاز المستخدم وتعرض الأنشطة المتاحة من أجهزة المستخدم الأخرى القريبة من خلال نقاط دخول مختلفة، مثل مشغّل التطبيقات وشريط المهام، على الجهاز المستلِم.

يمكن للتطبيقات تحديد ميزة "نقل البيانات" لتشغيل تطبيق Android الأصلي نفسه، إذا كان مثبّتًا ومتوفّرًا على الجهاز المستلِم. في مسار التنقّل من تطبيق إلى آخر هذا، يتم توجيه المستخدم إلى الصفحة المحدّدة في التطبيق. يمكن بدلاً من ذلك توفير ميزة "نقل البيانات من التطبيق إلى الويب" كخيار احتياطي أو تنفيذها مباشرةً باستخدام ميزة "نقل البيانات من عنوان URL".

يتم تنفيذ ميزة Handoff على أساس كل نشاط. لتفعيل ميزة "التسليم"، استدعِ طريقة setHandoffEnabled() للنشاط. قد يلزم تمرير بيانات إضافية مع عملية التسليم حتى تتمكّن الأنشطة التي تم إنشاؤها من جديد على الجهاز المستلِم من استعادة الحالة المناسبة. نفِّذ الدالة onHandoffActivityRequested() للردّ على الاتصال من أجل عرض كائن HandoffActivityData يحتوي على تفاصيل تحدّد كيفية تعامل ميزة "نقل النشاط" مع النشاط وإعادة إنشائه على الجهاز المستلِم.

تحديث مباشر - واجهة برمجة تطبيقات الألوان الدلالية

في نظام التشغيل Android 17، تطلق ميزة التحديث المباشر واجهات برمجة التطبيقات Semantic Coloring لدعم الألوان ذات المعنى العالمي.

تتيح الفئات التالية التلوين الدلالي:

ألعاب التلوين

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

يوضّح المثال التالي كيفية تطبيق أنماط دلالية على نص في إشعار:

  val ssb = SpannableStringBuilder()
        .append("Colors: ")
        .append("NONE", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_UNSPECIFIED), 0)
        .append(", ")
        .append("INFO", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_INFO), 0)
        .append(", ")
        .append("SAFE", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_SAFE), 0)
        .append(", ")
        .append("CAUTION", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_CAUTION), 0)
        .append(", ")
        .append("DANGER", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_DANGER), 0)

    Notification.Builder(context, channelId)
          .setSmallIcon(R.drawable.ic_icon)
          .setContentTitle("Hello World!")
          .setContentText(ssb)
          .setOngoing(true)
              .setRequestPromotedOngoing(true)

UWB Downlink-TDoA API لنظام التشغيل Android 17

下行链路到达时间差 (DL-TDoA) 测距技术可让设备通过测量信号的相对到达时间来确定其相对于多个锚点的位置。

以下代码段演示了如何初始化 Ranging Manager、验证设备功能并启动 DL-TDoA 会话：

Kotlin

class RangingApp {

    fun initDlTdoa(context: Context) {
        // Initialize the Ranging Manager
        val rangingManager = context.getSystemService(RangingManager::class.java)

        // Register for device capabilities
        val capabilitiesCallback = object : RangingManager.CapabilitiesCallback {
            override fun onRangingCapabilities(capabilities: RangingCapabilities) {
                // Make sure Dl-TDoA is supported before starting the session
                if (capabilities.uwbCapabilities != null && capabilities.uwbCapabilities!!.isDlTdoaSupported) {
                    startDlTDoASession(context)
                }
            }
        }
        rangingManager.registerCapabilitiesCallback(Executors.newSingleThreadExecutor(), capabilitiesCallback)
    }

    fun startDlTDoASession(context: Context) {

        // Initialize the Ranging Manager
        val rangingManager = context.getSystemService(RangingManager::class.java)

        // Create session and configure parameters
        val executor = Executors.newSingleThreadExecutor()
        val rangingSession = rangingManager.createRangingSession(executor, RangingSessionCallback())
        val rangingRoundIndexes = intArrayOf(0)
        val config: ByteArray = byteArrayOf() // OOB config data
        val params = DlTdoaRangingParams.createFromFiraConfigPacket(config, rangingRoundIndexes)

        val rangingDevice = RangingDevice.Builder().build()
        val rawTagDevice = RawRangingDevice.Builder()
            .setRangingDevice(rangingDevice)
            .setDlTdoaRangingParams(params)
            .build()

        val dtTagConfig = RawDtTagRangingConfig.Builder(rawTagDevice).build()

        val preference = RangingPreference.Builder(DEVICE_ROLE_DT_TAG, dtTagConfig)
            .setSessionConfig(SessionConfig.Builder().build())
            .build()

        // Start the ranging session
        rangingSession.start(preference)
    }
}

private class RangingSessionCallback : RangingSession.Callback {
    override fun onDlTdoaResults(peer: RangingDevice, measurement: DlTdoaMeasurement) {
        // Process measurement results here
    }
}

Java

public class RangingApp {

    public void initDlTdoa(Context context) {

        // Initialize the Ranging Manager
        RangingManager rangingManager = context.getSystemService(RangingManager.class);

        // Register for device capabilities
        RangingManager.CapabilitiesCallback capabilitiesCallback = new RangingManager.CapabilitiesCallback() {
            @Override
            public void onRangingCapabilities(RangingCapabilities capabilities) {
                // Make sure Dl-TDoA is supported before starting the session
                if (capabilities.getUwbCapabilities() != null && capabilities.getUwbCapabilities().isDlTdoaSupported) {
                    startDlTDoASession(context);
                }
            }
        };
        rangingManager.registerCapabilitiesCallback(Executors.newSingleThreadExecutor(), capabilitiesCallback);
    }

    public void startDlTDoASession(Context context) {
        RangingManager rangingManager = context.getSystemService(RangingManager.class);

        // Create session and configure parameters
        Executor executor = Executors.newSingleThreadExecutor();
        RangingSession rangingSession = rangingManager.createRangingSession(executor, new RangingSessionCallback());
        int[] rangingRoundIndexes = new int[] {0};
        byte[] config = new byte[0]; // OOB config data
        DlTdoaRangingParams params = DlTdoaRangingParams.createFromFiraConfigPacket(config, rangingRoundIndexes);

        RangingDevice rangingDevice = new RangingDevice.Builder().build();
        RawRangingDevice rawTagDevice = new RawRangingDevice.Builder()
                .setRangingDevice(rangingDevice)
                .setDlTdoaRangingParams(params)
                .build();

        RawDtTagRangingConfig dtTagConfig = new RawDtTagRangingConfig.Builder(rawTagDevice).build();

        RangingPreference preference = new RangingPreference.Builder(DEVICE_ROLE_DT_TAG, dtTagConfig)
                .setSessionConfig(new SessionConfig.Builder().build())
                .build();

        // Start the ranging session
        rangingSession.start(preference);
    }

    private static class RangingSessionCallback implements RangingSession.Callback {

        @Override
        public void onDlTdoaResults(RangingDevice peer, DlTdoaMeasurement measurement) {
            // Process measurement results here
        }
    }
}

带外 (OOB) 配置

以下代码段提供了 Wi-Fi 和 BLE 的 DL-TDoA OOB 配置数据示例：

Java

// Wifi Configuration
byte[] wifiConfig = {
    (byte) 0xDD, (byte) 0x2D, (byte) 0x5A, (byte) 0x18, (byte) 0xFF, // Header
    (byte) 0x5F, (byte) 0x19, // FiRa Sub-Element
    (byte) 0x02, (byte) 0x00, // Profile ID
    (byte) 0x06, (byte) 0x02, (byte) 0x20, (byte) 0x08, // MAC Address
    (byte) 0x14, (byte) 0x01, (byte) 0x0C, // Preamble Index
    (byte) 0x27, (byte) 0x02, (byte) 0x08, (byte) 0x07, // Vendor ID
    (byte) 0x28, (byte) 0x06, (byte) 0xCA, (byte) 0xC8, (byte) 0xA6, (byte) 0xF7, (byte) 0x6F, (byte) 0x08, // Static STS IV
    (byte) 0x08, (byte) 0x02, (byte) 0x60, (byte) 0x09, // Slot Duration
    (byte) 0x1B, (byte) 0x01, (byte) 0x0A, // Slots per RR
    (byte) 0x09, (byte) 0x04, (byte) 0xE8, (byte) 0x03, (byte) 0x00, (byte) 0x00, // Duration
    (byte) 0x9F, (byte) 0x04, (byte) 0x67, (byte) 0x45, (byte) 0x23, (byte) 0x01  // Session ID
};

// BLE Configuration
byte[] bleConfig = {
    (byte) 0x2D, (byte) 0x16, (byte) 0xF4, (byte) 0xFF, // Header
    (byte) 0x5F, (byte) 0x19, // FiRa Sub-Element
    (byte) 0x02, (byte) 0x00, // Profile ID
    (byte) 0x06, (byte) 0x02, (byte) 0x20, (byte) 0x08, // MAC Address
    (byte) 0x14, (byte) 0x01, (byte) 0x0C, // Preamble Index
    (byte) 0x27, (byte) 0x02, (byte) 0x08, (byte) 0x07, // Vendor ID
    (byte) 0x28, (byte) 0x06, (byte) 0xCA, (byte) 0xC8, (byte) 0xA6, (byte) 0xF7, (byte) 0x6F, (byte) 0x08, // Static STS IV
    (byte) 0x08, (byte) 0x02, (byte) 0x60, (byte) 0x09, // Slot Duration
    (byte) 0x1B, (byte) 0x01, (byte) 0x0A, // Slots per RR
    (byte) 0x09, (byte) 0x04, (byte) 0xE8, (byte) 0x03, (byte) 0x00, (byte) 0x00, // Duration
    (byte) 0x9F, (byte) 0x04, (byte) 0x67, (byte) 0x45, (byte) 0x23, (byte) 0x01  // Session ID
};

如果您无法使用 OOB 配置（因为缺少该配置），或者需要更改不在 OOB 配置中的默认值，则可以使用 DlTdoaRangingParams.Builder 构建参数，如以下代码段所示。您可以使用以下参数代替 DlTdoaRangingParams.createFromFiraConfigPacket()：

Kotlin

val dlTdoaParams = DlTdoaRangingParams.Builder(1)
    .setComplexChannel(UwbComplexChannel.Builder()
            .setChannel(9).setPreambleIndex(10).build())
    .setDeviceAddress(deviceAddress)
    .setSessionKeyInfo(byteArrayOf(0x01, 0x02, 0x03, 0x04))
    .setRangingIntervalMillis(240)
    .setSlotDuration(UwbRangingParams.DURATION_2_MS)
    .setSlotsPerRangingRound(20)
    .setRangingRoundIndexes(byteArrayOf(0x01, 0x05))
    .build()

Java

DlTdoaRangingParams dlTdoaParams = new DlTdoaRangingParams.Builder(1)
    .setComplexChannel(new UwbComplexChannel.Builder()
            .setChannel(9).setPreambleIndex(10).build())
    .setDeviceAddress(deviceAddress)
    .setSessionKeyInfo(new byte[]{0x01, 0x02, 0x03, 0x04})
    .setRangingIntervalMillis(240)
    .setSlotDuration(UwbRangingParams.DURATION_2_MS)
    .setSlotsPerRangingRound(20)
    .setRangingRoundIndexes(new byte[]{0x01, 0x05})
    .build();

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

الوظيفة الأساسية

عوامل تشغيل ProfilingManager الجديدة

واجهات برمجة التطبيقات JobDebugInfo

الخصوصية

أداة اختيار جهات الاتصال على Android

الأمان

وضع "الحماية المتقدّمة على Android" (AAPM)

إمكانية الاتصال

شبكات الأقمار الصناعية ذات النطاق الترددي المحدود

تجربة المستخدم وواجهة مستخدم النظام

النقل

تحديث مباشر - واجهة برمجة تطبيقات الألوان الدلالية

ألعاب التلوين

UWB Downlink-TDoA API لنظام التشغيل Android 17

Kotlin

Java

带外 (OOB) 配置

Java

Kotlin

Java

الميزات وواجهات برمجة التطبيقات