Мониторинг использования флэш-памяти

Watchdog отслеживает использование флэш-памяти, отслеживая общий объем операций ввода-вывода на диск, выполненных всеми приложениями и службами, используя статистику ввода-вывода диска для каждого UID, предоставляемую ядром в расположении `/proc/uid_io/stats`. Когда приложение или служба превышает порог чрезмерного использования дискового ввода-вывода, Watchdog предпринимает действия в отношении приложения или службы. Пороговые значения чрезмерного использования дискового ввода-вывода и действия, предпринимаемые в случае чрезмерного использования, заранее определены в конфигурации чрезмерного использования дискового ввода-вывода.

Пороги чрезмерного использования

  • Пороговые значения чрезмерного использования дискового ввода-вывода применяются ежедневно, то есть все операции записи, выполняемые приложением или службой, суммируются с начала текущего календарного дня по всемирному координированному времени и проверяются на соответствие пороговым значениям, определенным в конфигурациях чрезмерного использования.
  • Когда автомобиль запускается несколько раз в определенный день, модуль Watchdog сохраняет статистику использования дискового ввода-вывода во флэш-памяти и суммирует ее с начала текущего календарного дня UTC.

Действия по злоупотреблению

Когда приложение неоднократно превышает определенные пороговые значения чрезмерного использования дискового ввода-вывода, Watchdog предпринимает действия, определенные в конфигурации чрезмерного использования.

  • Все приложения и службы поставщиков считаются критически важными для общей стабильности системы, поэтому их работа не прекращается из-за чрезмерного использования дискового ввода-вывода. Однако конфигурация чрезмерного использования может определить список приложений и служб поставщика, которые можно безопасно завершить.
  • Все сторонние приложения можно безопасно закрыть.

Когда приложение или службу можно безопасно завершить, Watchdog отключает приложение или службу с помощью состояния компонента приложения PackageManager.COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED .

Конфигурация чрезмерного использования

Конфигурация чрезмерного использования содержит пороговые значения и действия по превышению дискового ввода-вывода. Конфигурации чрезмерного использования по умолчанию определены в образах системы и поставщика и поставляются вместе со сборкой. Поставщики могут дополнительно включить конфигурацию поставщика в образ поставщика. Если конфигурация поставщика не указана, конфигурация системы также используется для приложений и служб поставщика.

Watchdog предоставляет системные API через CarWatchdogManager , который позволяет приложениям или службам поставщиков обновлять конфигурацию поставщика в любое время.

Определение конфигурации чрезмерного использования

Конфигурация чрезмерного использования разделяется по типу компонента, например, система, поставщик или третья сторона. OEM-производители должны обновлять только конфигурацию компонентов поставщика.

Конфигурация поставщика

Конфигурация поставщика определяет пороговые значения и действия по чрезмерному использованию дискового ввода-вывода для всех приложений и служб поставщика, а также всех карт и мультимедийных приложений. Конфигурация содержит приведенные ниже поля конфигурации.

  • Префиксы пакетов поставщиков . Все пакеты, установленные в разделе поставщика, считаются пакетами поставщика. В дополнение к этим пакетам поставщики могут классифицировать предустановленные пакеты как пакеты поставщиков, добавляя префиксы пакетов в конфигурацию префиксов пакетов поставщиков . Эта конфигурация не принимает регулярные выражения.
  • Пакеты безопасного завершения . Поставщики могут указать, какие пакеты поставщиков можно безопасно завершить, добавив полные имена пакетов в конфигурацию безопасных для завершения пакетов .
  • Сопоставление категорий приложений . Поставщики могут сопоставить любой пакет (включая пакеты сторонних производителей) с одной из двух поддерживаемых категорий приложений — приложениями «Карта» и «Мультимедиа». Такое сопоставление сделано для того, чтобы обеспечить картам и мультимедийным приложениям более высокие пороговые значения чрезмерного использования дискового ввода-вывода, поскольку эти приложения имеют тенденцию загружать и записывать на диск больше данных, чем другие типы приложений.
  • Пороговые значения уровня компонентов . Определяет общие пороговые значения для всех пакетов поставщиков (то есть пакеты, на которые не распространяются пороговые значения для конкретного пакета или пороговые значения для конкретной категории приложения, получают эти пороговые значения). Поставщики должны определить ненулевые пороговые значения на уровне компонентов при определении конфигурации чрезмерного использования дискового ввода-вывода.
  • Пороги, специфичные для пакета . Поставщики могут определять специальные пороговые значения для пакетов конкретных поставщиков. Сопоставления должны содержать полные имена пакетов. Пороги, определенные в этой конфигурации, имеют приоритет над порогами, определенными в других конфигурациях для данного пакета.
  • Пороговые значения для конкретных категорий приложений . Поставщики могут указать специальные пороговые значения для определенных категорий приложений. Категории приложений должны быть одной из поддерживаемых категорий — «Карты» и «Мультимедиа». Пороговые значения, определенные в этой конфигурации, сопоставляются с конкретными пакетами с помощью сопоставлений категорий приложений .
  • Общесистемные пороги . Поставщики не должны указывать эту конфигурацию.

Префиксы пакетов поставщика , пакеты Safe-to-Treminate , пороговые значения уровня компонентов и конфигурации пороговых значений для конкретных пакетов обновляются только конфигурацией поставщика для приложений и служб поставщика. Конфигурация пороговых значений для конкретной категории приложений может быть обновлена ​​только конфигурацией поставщика для всех карт и мультимедийных приложений.

Пороги чрезмерного использования содержат количество байт, которое разрешено записать во время:

  • Режим переднего плана приложения или службы в сравнении с фоновым режимом
  • Системный гаражный режим

Эта классификация позволяет пользователю, работающему с приложениями и службами переднего плана, записывать больше данных, чем фоновые приложения и службы. В режиме «Гараж» приложения и службы обычно загружают обновления, поэтому для каждого из них требуется более высокий порог, чем для приложений и служб, работающих в других режимах.

Системные и сторонние конфигурации

OEM-производители не должны обновлять системы и конфигурации сторонних производителей.

  • Конфигурация системы определяет пороговые значения чрезмерного использования ввода-вывода и действия для системных приложений и служб.
    • Эта конфигурация также может обновлять сопоставления категорий приложений . Таким образом, это поле конфигурации является общим для конфигураций системы и поставщика.
  • Сторонняя конфигурация определяет пороговые значения для всех сторонних приложений. Все приложения, которые не предустановлены в системе, являются сторонними.
    • Все сторонние приложения получают одинаковые пороговые значения (например, ни одно стороннее приложение не получает специальных пороговых значений), за исключением карт и мультимедийных приложений, пороговые значения которых определяются конфигурацией поставщика.
    • Приведенные ниже пороговые значения чрезмерного использования дискового ввода-вывода являются пороговыми значениями по умолчанию для сторонних приложений. Эти пороговые значения поставляются с образом системы.
      • 3 ГиБ записи в режиме переднего плана приложения.
      • 2 ГиБ записи в фоновом режиме приложения.
      • 4 ГиБ пишутся в режиме системного гаража.
    • Это базовые пороги. Эти пороговые значения обновляются по мере получения дополнительной информации об использовании дискового ввода-вывода.

Злоупотребление форматом XML конфигурации

Конфигурацию поставщика по умолчанию можно разместить (это необязательно ) в папке /vendor/etc/automotive/watchdog/resource_overuse_configuration.xml в образе сборки. Если эта конфигурация не указана, определенная системой конфигурация также применяется к приложениям и службам поставщика.

XML-файл должен содержать только один тег для каждого поля конфигурации. Конфигурация чрезмерного использования ввода-вывода должна быть определена в файле XML. Все пороговые значения следует указывать в единицах МиБ.

Пример конфигурации XML приведен ниже:

<resourceOveruseConfiguration version="1.0">
      <componentType> VENDOR </componentType>

      <!-- List of safe to kill vendor packages. -->
      <safeToKillPackages>
            <package> com.vendor.package.A </package>
            <package> com.vendor.package.B </package>
      </safeToKillPackages>

      <!-- List of vendor package prefixes. -->
      <vendorPackagePrefixes>
            <packagePrefix> com.vendor.package </packagePrefix>
      </vendorPackagePrefixes>

      <!-- List of unique package names to app category mappings. -->
      <packagesToAppCategoryTypes>
            <packageAppCategory type="MEDIA"> com.vendor.package.A </packageAppCategory>
            <packageAppCategory type="MAPS"> com.google.package.B </packageAppCategory>
            <packageAppCategory type="MEDIA"> com.third.party.package.C </packageAppCategory>
      </packagesToAppCategoryTypes>

      <ioOveruseConfiguration>
        <!-- Thresholds in MiB for all vendor packages that don't have package specific thresholds. -->
            <componentLevelThresholds>
                  <state id="foreground_mode"> 1024 </state>
                  <state id="background_mode"> 512 </state>
                  <state id="garage_mode"> 3072 </state>
            </componentLevelThresholds>

            <packageSpecificThresholds>
                  <!-- IDs must be unique -->
                  <perStateThreshold id="com.vendor.package.C">
                    <state id="foreground_mode"> 400 </state>
                    <state id="background_mode"> 100 </state>
                    <state id="garage_mode"> 200 </state>
                  </perStateThreshold>

                  <perStateThreshold id="com.vendor.package.D">
                    <state id="foreground_mode"> 1024 </state>
                    <state id="background_mode"> 500 </state>
                    <state id="garage_mode"> 2048 </state>
                  </perStateThreshold>
            </packageSpecificThresholds>

            <!-- Application category specific thresholds. -->
            <appCategorySpecificThresholds>
                  <!-- One entry per supported application category -->
                  <perStateThreshold id="MEDIA">
                    <state id="foreground_mode"> 600 </state>
                    <state id="background_mode"> 700 </state>
                    <state id="garage_mode"> 1024 </state>
                  </perStateThreshold>

                  <perStateThreshold id="MAPS">
                    <state id="foreground_mode"> 800 </state>
                    <state id="background_mode"> 900 </state>
                    <state id="garage_mode"> 2048 </state>
                  </perStateThreshold>
            </appCategorySpecificThresholds>
      </ioOveruseConfiguration>
</resourceOveruseConfiguration>

Обновите конфигурацию чрезмерного использования через системные API CarWatchdogManager.

Вышеупомянутая конфигурация XML может быть предоставлена ​​только в образе сборки. Если OEM-производитель решит обновить конфигурацию устройства после выпуска сборки, он может использовать следующие API для внесения изменений в конфигурацию устройства.

  • Предоставьте разрешение Car.PERMISSION_CONTROL_CAR_WATCHDOG_CONFIG вызывающему объекту.
  • Необходимо использовать существующие конфигурации для обновления и установки новых конфигураций. Используйте API CarWatchdogManager.getResourceOveruseConfigurations чтобы получить существующие конфигурации. Если существующие конфигурации не используются, все конфигурации (включая системные и сторонние) перезаписываются, что не рекомендуется.
  • Обновите существующие конфигурации с учетом дельта-изменений и установите новые конфигурации. Не обновляйте конфигурации системы и сторонних компонентов.
  • Используйте API CarWatchdogManager.setResourceOveruseConfigurations чтобы установить новые конфигурации.
  • Чтобы получить и установить конфигурации чрезмерного использования дискового ввода-вывода, используйте флаг CarWatchdogManager.FLAG_RESOURCE_OVERUSE_IO .

Вот пример реализации, которая обновляет конфигурации чрезмерного использования ресурсов:

void updateResourceOveruseConfigurations() {
    CarWatchdogManager manager =
        (CarWatchdogManager) car.getCarManager(Car.CAR_WATCHDOG_SERVICE);

    List<ResourceOveruseConfiguration> resourceOveruseConfigurations =
        manager.getResourceOveruseConfigurations(
            CarWatchdogManager.FLAG_RESOURCE_OVERUSE_IO);

    List<ResourceOveruseConfiguration> newResourceOveruseConfigurations =
            new List<>();
    ResourceOveruseConfiguration vendorConfiguration;
    for(ResourceOveruseConfiguration config : resourceOveruseConfigurations) {
        // Do not update the configurations of the system and third-party component types.
        if (config.getComponentType()
            != ResourceOveruseConfiguration.COMPONENT_TYPE_VENDOR) {
            newResourceOveruseConfigurations.add(config);
            continue;
        }
        vendorConfiguration = config;
    }

    if (vendorConfiguration == null) {
        ResourceOveruseConfiguration.Builder vendorConfigBuilder =
            new ResourceOveruseConfiguration.Builder();
        initializeConfig(vendorConfigBuilder);
        newResourceOveruseConfigurations.add(vendorConfigBuilder.build());
    } else {
        ResourceOveruseConfiguration newVendorConfig =
            updateConfig(vendorConfiguration);
        newResourceOveruseConfigurations.add(newVendorConfig);
    }
    int result = manager.setResourceOveruseConfigurations(
        newResourceOveruseConfigurations,

    if (result != CarWatchdogManager.RETURN_CODE_SUCCESS) {
        // Failed to set the resource overuse configurations.
    }
}

/** Sets the delta between the old configuration and the new configuration. */
ResourceOveruseConfiguration updateConfig(
    ResourceOveruseConfiguration oldConfiguration) {
    // Replace com.vendor.package.A with com.vendor.package.B in the safe-to-kill list.
    List<String> safeToKillPackages = oldConfiguration.getSafeToKillPackages();
    safeToKillPackages.remove("com.vendor.package.A");
    safeToKillPackages.add("com.vendor.package.B");

    ResourceOveruseConfiguration.Builder configBuilder =
        new ResourceOveruseConfiguration.Builder(
            oldConfiguration.getComponentType(),
            safeToKillPackages,
            oldConfiguration.getVendorPackagePrefixes(),
            oldConfiguration.getPackagesToAppCategoryTypes());

    configBuilder.addVendorPackagePrefixes("com.vendor.");
    configBuilder.addPackagesToAppCategoryTypes("com.vendor.package.B",
        ResourceOveruseConfiguration.APPLICATION_CATEGORY_TYPE_MAPS);

    IoOveruseConfiguration oldIoConfiguration = oldConfiguration.getIoOveruseConfiguration();
    IoOveruseConfiguration.Builder ioConfigBuilder =
        new IoOveruseConfiguration.Builder(
            oldIoConfiguration.getComponentLevelThresholds(),
            oldIoConfiguration.getPackageSpecificThresholds(),
            oldIoConfiguration.getAppCategorySpecificThresholds(),
            oldIoConfiguration.getSystemWideThresholds());

    // Define the amount of bytes based on the flash memory specification, expected lifetime,
    // and estimated average amount of bytes written by a package during different modes.
    ioConfigBuilder.addPackageSpecificThresholds("com.vendor.package.B",
        new PerStateBytes(/* foregroundModeBytes= */ 2 * 1024 * 1024 * 1024,
                          /* backgroundModeBytes= */ 500 * 1024 * 1024,
                          /* garageModeBytes= */ 3 * 1024 * 1024 * 1024));


    return configBuilder.setIoOveruseConfiguration(ioConfigBuilder.build()).build();
}

Приложения отслеживают чрезмерное использование ресурсов

Приложения поставщиков и сторонних производителей могут прослушивать уведомления о чрезмерном использовании ресурсов конкретного приложения от Watchdog или опрашивать CarWatchdogManager для получения статистики чрезмерного использования ресурсов конкретного приложения за последние 30 дней.

Слушайте уведомления о чрезмерном использовании ресурсов

Приложения могут реализовать прослушиватель чрезмерного использования ресурсов и зарегистрировать его в CarWatchdogManager чтобы получать уведомления для конкретных приложений, когда они превышают 80 % или 100 % пороговых значений чрезмерного использования дискового ввода-вывода. Приложения могут использовать эти уведомления, чтобы:

  • Запишите статистику чрезмерного использования дискового ввода-вывода для автономного анализа. Разработчики приложений могут использовать это ведение журнала для устранения проблемы чрезмерного использования дискового ввода-вывода.
  • Уменьшайте количество операций ввода-вывода на диск до тех пор, пока счетчики чрезмерного использования не обнулятся.

Java-клиент

  1. Реализуйте прослушиватель, унаследовав CarWatchdogManager.ResourceOveruseListener :
    class ResourceOveruseListenerImpl implements
          CarWatchdogManager.ResourceOveruseListener {
                @Override
                public void onOveruse(
                      @NonNull ResourceOveruseStats resourceOveruseStats) {
                      // 1. Log/Upload resource overuse metrics.
                      // 2. Reduce writes until the counters reset.
    
                      IoOveruseStats ioOveruseStats = resourceOveruseStats.getIoOveruseStats();
                      // Stats period - [ioOveruseStats.getStartTime(), ioOveruseStats.getStartTime()
                      //   + ioOveruseStats.getDurationInSeconds()]
                      // Total I/O overuses - ioOveruseStats.getTotalOveruses()
                      // Total bytes written - ioOveruseStats.getTotalBytesWritten()
                      // Remaining write bytes for the current UTC calendar day -
                      //    ioOveruseStats.getRemainingWriteBytes()
                }
          }
    }
  2. Зарегистрируйте экземпляр прослушивателя, вызвав CarWatchdogManager.addResourceOveruseListener
    private void addResourceOveruseListener() {
          CarWatchdogManager manager =
                (CarWatchdogManager) car.getCarManager(Car.CAR_WATCHDOG_SERVICE);
          // Choose a proper executor to handle resource overuse notifications.
          Executor executor = mContext.getMainExecutor();
          manager.addResourceOveruseListener(
                executor, CarWatchdogManager.FLAG_RESOURCE_OVERUSE_IO,
                mListenerImpl);
    }
  3. Отмените регистрацию экземпляра прослушивателя, когда приложение завершит прослушивание:
    private void removeResourceOveruseListener() {
        CarWatchdogManager manager =
                (CarWatchdogManager) car.getCarManager(Car.CAR_WATCHDOG_SERVICE);
        mCarWatchdogManager.removeResourceOveruseListener(
              mListenerImpl);
    }

Родной клиент

  1. Включите carwatchdog_aidl_interface-ndk_platform в shared_libs правила сборки.

    Android.bp

    cc_binary {
        name: "sample_native_client",
        srcs: [
            "src/*.cpp"
        ],
        shared_libs: [
            "carwatchdog_aidl_interface-ndk_platform",
            "libbinder_ndk",
        ],
        vendor: true,
    }
  2. Добавьте политику SELinux, чтобы разрешить домену службы поставщика использовать связующее ( binder_user ), и добавьте домен службы поставщика в клиентский домен carwatchdog (carwatchdog_client_domain macro) . См. код ниже для sample_client.te и file_contexts .

    sample_client.te

    type sample_client, domain;
    type sample_client_exec, exec_type, file_type, vendor_file_type;
    
    carwatchdog_client_domain(sample_client)
    
    init_daemon_domain(sample_client)
    binder_use(sample_client)

    file_contexts

    /vendor/bin/sample_native_client  u:object_r:sample_client_exec:s0
  3. Реализуйте прослушиватель чрезмерного использования ресурсов, унаследовав BnResourceOveruseListener . Переопределить BnResourceOveruseListener::onOveruse для обработки уведомлений о чрезмерном использовании ресурсов.

    ResourceOveruseListenerImpl.h

    class ResourceOveruseListenerImpl : public BnResourceOveruseListener {
    public:
        ndk::ScopedAStatus onOveruse(
            ResourceOveruseStats resourceOveruseStats) override;
    
    private:
        void initialize();
        void terminate();
    
        std::shared_ptr<ICarWatchdog> mWatchdogServer;
        std::shared_ptr<IResourceOveruseListener> mListener;
    }

    ResourceOveruseListenerImpl.cpp

    ndk::ScopedAStatus ResourceOveruseListenerImpl::onOveruse(
          ResourceOveruseStats resourceOveruseStats) {
    
          // 1. Log/Upload resource overuse metrics.
          // 2. Reduce writes until the counters reset.
    
          if (stats.getTag() != ResourceOveruseStats::ioOveruseStats) {
                // Received resourceOveruseStats doesn't contain I/O overuse stats.
          }
    
          const IoOveruseStats& ioOveruseStats = stats.get();
          // Stats period - [ioOveruseStats.startTime,
          //   ioOveruseStats.startTime + ioOveruseStats.durationInSeconds]
          // Total I/O overuses - ioOveruseStats.totalOveruses
          // Total bytes written - ioOveruseStats.writtenBytes
          // Remaining write bytes for the current UTC calendar day -
          //    ioOveruseStats.remainingWriteBytes
    
          return ndk::ScopedAStatus::ok();
    }
  4. Запустите пул потоков связывания и зарегистрируйте прослушиватель чрезмерного использования ресурсов на сторожевом сервере. Сервер Watchdog зарегистрирован под именем службы android.automotive.watchdog.ICarWatchdog/default .

    main.cpp

    int main(int argc, char** argv) {
        ABinderProcess_setThreadPoolMaxThreadCount(1);
        ABinderProcess_startThreadPool();
        std::shared_ptr<ResourceOveruseListenerImpl> listener =
            ndk::SharedRefBase::make<ResourceOveruseListenerImpl>();
    
        // The listener is added in initialize().
        listener->initialize();
    
        ... Run service ...
    
        // The listener is removed in terminate().
        listener->terminate();
    }

    ResourceOveruseListenerImpl.cpp

    void ResourceOveruseListener::initialize() {
        ndk::SpAIBinder binder(AServiceManager_getService(
                "android.automotive.watchdog.ICarWatchdog/default"));
        std::shared_ptr<ICarWatchdog> server = ICarWatchdog::fromBinder(binder);
        mWatchdogServer = server;
    
        std::shared_ptr<IResourceOveruseListener> listener =
            IResourceOveruseListener::fromBinder(this->asBinder());
        mWatchdogServer->addResourceOveruseListener(
          std::vector<int>{ResourceType.IO}, listener);
        mListener = listener;
    }
    
    void ResourceOveruseListener::terminate() {
        mWatchdogServer->removeResourceOveruseListener(mListener);
    }

Статистика чрезмерного использования ресурсов опроса

Приложения могут опрашивать CarWatchdogManager для получения статистики чрезмерного использования ввода-вывода ATS для конкретного приложения за последние 30 дней.

Java-клиент

Используйте CarWatchdogManager.getResourceOveruseStats чтобы получить статистику чрезмерного использования ресурсов. Передайте флаг CarWatchdogManager.FLAG_RESOURCE_OVERUSE_IO чтобы получить статистику чрезмерного использования дискового ввода-вывода.

private void getResourceOveruseStats() {
      CarWatchdogManager manager =
            (CarWatchdogManager) car.getCarManager(Car.CAR_WATCHDOG_SERVICE);

      // Returns resource overuse stats with I/O overuse stats for the past
      // 7 days. Stats are available for up to the past 30 days.
      ResourceOveruseStats resourceOveruseStats =
            mCarWatchdogManager.getResourceOveruseStats(
                  CarWatchdogManager.FLAG_RESOURCE_OVERUSE_IO,
                  CarWatchdogManager.STATS_PERIOD_PAST_7_DAYS);

      IoOveruseStats ioOveruseStats = resourceOveruseStats.getIoOveruseStats();
      // Stats period - [ioOveruseStats.getStartTime(), ioOveruseStats.getStartTime()
      //   + ioOveruseStats.getDurationInSeconds()]
      // Total I/O overuses - ioOveruseStats.getTotalOveruses()
      // Total bytes written - ioOveruseStats.getTotalBytesWritten()
      // Remaining write bytes for the UTC calendar day -
      //    ioOveruseStats.getRemainingWriteBytes()
}

Родной клиент

Используйте CarWatchdogServer.getResourceOveruseStats чтобы получить статистику чрезмерного использования ресурсов. Передайте перечисление ResourceType.IO , чтобы получить статистику чрезмерного использования дискового ввода-вывода.

void getResourceOveruseStats() {
      ndk::SpAIBinder binder(AServiceManager_getService(
            "android.automotive.watchdog.ICarWatchdog/default"));
      std::shared_ptr<ICarWatchdog> server = ICarWatchdog::fromBinder(binder);
      // Returns the stats only for the current UTC calendar day.
      const std::vector<ResourceOveruseStats> resourceOveruseStats;
      ndk::ScopedAStatus status = server.getResourceOveruseStats(
            std::vector<int>{ResourceType.IO}, &resourceOveruseStats);
      if (!status.isOk()) {
            // Failed to get the resource overuse stats.
            return;
      }

      for (const auto& stats : resourceOveruseStats) {
            if (stats.getTag() != ResourceOveruseStats::ioOveruseStats) {
                  continue;
            }
            const IoOveruseStats& ioOveruseStats = stats.get();
            // Stats period - [ioOveruseStats.startTime,
            //   ioOveruseStats.startTime + ioOveruseStats.durationInSeconds]
            // Total I/O overuses - ioOveruseStats.totalOveruses
            // Total bytes written - ioOveruseStats.writtenBytes
            // Remaining write bytes for the current UTC calendar day -
            //   ioOveruseStats.remainingWriteBytes
      }
}

Пользовательский опыт чрезмерного использования ресурсов

В следующих разделах описываются действия пользователя в случае чрезмерного использования ресурсов.

Приоритизация настроек производительности приложения

Страница настроек приложения содержит настройки для Prioritize app performance (см. изображение ниже), которые позволяют пользователям устанавливать приоритет производительности приложения над системой и долгосрочной производительностью оборудования. Этот параметр доступен только для приложений, которые можно безопасно закрыть при чрезмерном использовании ресурсов. В противном случае этот параметр отключен. Если этот параметр для приложения отключен (настройка по умолчанию), приложение может быть прекращено из-за чрезмерного использования ресурсов. В противном случае приложение не будет закрыто из-за чрезмерного использования ресурсов.

Когда пользователь включает этот параметр, в следующем диалоговом окне подтверждения описываются последствия переключения этого параметра:

Через 90 дней этот параметр автоматически сбрасывается на значение по умолчанию. Дневной лимит можно изменить с помощью приложения наложения RRO с помощью watchdogUserPackageSettingsResetDays , максимум до 180 дней. Дополнительные сведения см. в разделе Изменение значения ресурсов приложения во время выполнения . Следующий пример тега наложения можно включить в AndroidManifest.xml :

<overlay android:priority="<insert-value>"
      android:targetPackage="com.android.car.updatable"
      android:targetName="CarServiceCustomization"
      android:resourcesMap="@xml/overlays" />

В res/values/config.xml :

<resources>
  <integer name="watchdogUserPackageSettingsResetDays">value</integer>
</resources>

В файле res/xml/overlays.xml :

<overlay>
  <item target="integer/watchdogUserPackageSettingsResetDays" value="@integer/watchdogUserPackageSettingsResetDays" />
</overlay>

Настройка приложений, влияющих на производительность

Приложение «Настройки» содержит раздел «Приложения, влияющие на производительность» (см. рис. 1). При нажатии отображается список приложений, использование которых было ограничено из-за чрезмерного использования флэш-памяти и которые негативно влияют на производительность системы. Это соответствует требованию CDD 3.5.1 [C-1-1] .

Приложения, влияющие на производительность

Рисунок 1. Приложения, влияющие на производительность.

Здесь перечислены приложения, работа которых прекращена из-за чрезмерного использования ресурсов (см. рис. 2). Перечисленным приложениям можно приоритезировать. Дополнительные сведения см. в разделе «Приоритет производительности приложения» .

Список приложений, закрытых из-за чрезмерного использования ресурсов

Рисунок 2. Список приложений, деятельность которых прекращена из-за чрезмерного использования ресурсов.

Уведомление пользователя

Когда приложение или служба неоднократно чрезмерно злоупотребляет дисковым вводом-выводом (например, записывает данные на диск сверх определенных пороговых значений) в течение определенного периода и может быть безопасно прекращено при чрезмерном использовании ресурсов, пользователь уведомляется после того, как транспортное средство входит в разрешенный драйвер. -состояние отвлечения.

Первое уведомление пользователя (во время поездки) публикуется как всплывающее уведомление, а остальные уведомления размещаются в центре уведомлений.

Например, когда приложение неоднократно чрезмерно использует дисковый ввод-вывод, пользователь получает следующее уведомление:

  • Когда пользователь нажимает кнопку «Приоритет приложения» , открывается страница настроек приложения, на которой пользователь может включать или выключать параметр «Приоритет производительности приложения» .
  • Когда пользователь нажимает кнопку «Отключить приложение» , приложение отключается до тех пор, пока пользователь не запустит его или не включит его на странице настроек приложения.
  • Для неустанавливаемых приложений кнопка «Отключить приложение» заменяется кнопкой «Удалить приложение» . Когда пользователь нажимает кнопку «Удалить приложение» , открывается страница настроек приложения, с которой пользователь может удалить приложение.

Рекомендации по внедрению лаунчера

Когда приложения отключены из-за чрезмерного использования ресурсов, они исчезают из приложения запуска по умолчанию, поскольку CarService обновляет включенное состояние приложений как PackageManager.COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED . OEM-производители должны обновить встроенную реализацию средства запуска, чтобы эти приложения отображались как необычные, чтобы пользователи могли использовать их при необходимости. См. следующие рекомендации, основанные на выпуске сборки.

Выпуск Android SC V2