Auswählen der richtigen Aktivitätskoordinatorrichtlinie

Der Aktivitätskoordinator stellt mehrere Vorlagenrichtlinien bereit, die basierend auf den für Ihre Aufgabe erforderlichen Ressourcen ausgewählt werden sollten.

Grundlegendes zu Ihrer Aktivitätsworkload

Bestimmen Sie die Ressourcen des Aktivitätskoordinators, die für Ihre Aufgabe erforderlich sind, und unter welchen Bedingungen Ihre Aufgabe ausgeführt werden soll. Die Profilerstellung für die Aufgabe mithilfe einer Leistungsablaufverfolgung ist ein guter Ausgangspunkt.

Auswählen von Ressourcen

Wählen Sie ressourcen aus, die aus der Leistungsablaufverfolgung abgeleitet wurden. Diese Ressourcen sollten die Ressourcen sein, auf die sich Ihre Aktivitätsworkload auswirken wird. Vergessen Sie nicht Die Ressourcen, die Sie implizit nutzen oder beeinflussen, z. B. Benutzer-Leerlauf und Energie.

Auswählen von Bedingungen

Wählen Sie Bedingungen basierend auf dem Ressourcenverbrauch Ihrer Workload aus, wie in der Leistungsablaufverfolgung beobachtet. Im Allgemeinen wird empfohlen, die besten Bedingungen für die benötigten Ressourcen zu verwenden und, falls erforderlich, Ihre Richtlinie mit niedrigeren Bedingungen zu aktualisieren, wenn sie Ihre Anforderungen nicht innerhalb des gewünschten Zeitrahmens erfüllt. Beginnend mit den besten Bedingungen und der Übergang zu niedrigeren Bedingungen wird vor der Ausführung bevorzugt, wenn Ihre Richtlinie nicht erfüllt ist (die Ressourcenbedingungen sind nicht erfüllt), um Fristen einzuhalten. Dies gibt der API die Möglichkeit, die Auswirkungen Ihrer Aktivität auf Benutzer und System zu minimieren und gleichzeitig die Möglichkeiten für die Ausführung Ihrer Aktivität zu erhöhen.

Für Workloads mit vernachlässigbarem oder geringem Ressourcenverbrauch können Bedingungen wie ACTIVITY_COORDINATOR_CONDITION_MEDIUM ohne negative Auswirkungen auf das System verwendet werden. Workloads mit höherem Verbrauch eignen sich besser für die Verwendung von Bedingungen, bei denen sich die Nutzung am wenigsten auf die Benutzererfahrung auswirkt, z. B. ACTIVITY_COORDINATOR_CONDITION_GOOD. Solche Workloads haben bei geringeren Bedingungen mit größerer Wahrscheinlichkeit erhebliche Auswirkungen, und diese Auswirkungen sind möglicherweise nicht vorübergehend. Beispielsweise kann die Nutzung des Internets unter einem mittleren Netzwerkzustand zu finanziellen Kosten für den Benutzer führen, wenn dieses Netzwerk getaktet und abgerechnet wird.

Beachten Sie die Gerätetypen und Konfigurationen, die Ihre Anwendung zusätzlich zu den Funktionen des Computers aus allen Leistungsablaufverfolgungen unterstützt. Variabilität in der Zielumgebung kann Unterschiede in der Art und Weise bedeuten, wie sich Ihre Workload auf den Benutzer, das System und die Wahrscheinlichkeit auswirkt, dass Ihre Richtlinie über einen bestimmten Zeitraum erfüllt wird.

Stichtag

Es kann verschiedene Zeiteinschränkungen geben, die mit Ihrer Aktivität verbunden sind. Länger laufende Arbeiten oder Arbeiten, die in relativ kurzer Zeit beginnen oder abgeschlossen werden müssen, können mit geringeren Bedingungen besser bedient werden, um die Wahrscheinlichkeit der Öffnung der Richtlinie zu erhöhen. Kürzere arbeitsintensive Arbeiten oder Arbeiten mit losen Zeitanforderungen können ihre Anforderungen unter den besten Bedingungen erfüllen. Über einen längeren Zeitraum hinweg wird das Zielsystem wahrscheinlich Perioden mit geringem Ressourcenverbrauch aufweisen. Wenn sich ein Stichtag nähert, empfehlen wir, Ihre Richtlinie herabzustufen, wenn keine ausreichenden Fortschritte erzielt wurden, bevor sie nach oder nach dem Annähern des Stichtags zu regulären Ausführungsmethoden greifen. Wiederholte Arbeit kann dann nach Abschluss zur ursprünglichen Richtlinie wechseln.

Vorlagenrichtlinien

Die API enthält eine Reihe von Vorlagenrichtlinien für das typische Arbeitsprofil, die für die ersten Schritte mit der API verwendet werden können. Für die meisten Programme, die lokales Computing durchführen, empfehlen wir die Verwendung der Vorlagenrichtlinien.

Richtlinienempfehlung

Wenn Sie von den bereitgestellten Vorlagenrichtlinien nicht sicher sind, welche Sie auswählen sollten, sollte die ACTIVITY_COORDINATOR_POLICY_TEMPLATE_GOOD in den meisten Fällen der Rechnung entsprechen. Diese Richtlinie minimiert die Auswirkungen des Benutzers und bietet gleichzeitig eine angemessene Wahrscheinlichkeit, dass die Richtlinie ausreichend offen ist, um die Arbeit des Entwicklers abzuschließen.

Anpassen von Vorlagenrichtlinien

Vorlagenrichtlinien lassen möglicherweise einige Ressourcen aus (z. B. GPU), die in allgemeinen Anwendungsfällen möglicherweise nicht erforderlich sind. Basierend auf der erwarteten Workload kann eine Richtlinie mithilfe der Vorlagenrichtlinien als Ausgangspunkt angepasst werden.

Erstellen von Richtlinien von Grund auf neu

Entwickler, die Vollzugriff benötigen, können mit einer leeren Richtlinie beginnen: ACTIVITY_COORDINATOR_POLICY_TEMPLATE_EMPTY. Für diese Szenarien wird jedoch empfohlen, mit ACTIVITY_COORDINATOR_POLICY_TEMPLATE_BASE zu beginnen, die die empfohlenen Mindestressourcen und Bedingungen für die meisten Situationen angibt. Dadurch wird sichergestellt, dass wichtige Ressourcenbedingungen nicht versehentlich ausgelassen werden, wenn sie eine Richtlinie von Grund auf neu konfigurieren, z. B. Benutzer-Leerlauf-, CPU- und Energieressourcen.

Übersicht über die Aktivitätskoordinator-API

Aktivitätskoordinator-API und Terminologie

Beispielprojekt "Aktivitätskoordinator"