Mediathek für die Veröffentlichung vorbereiten

Auf dieser Seite werden die Attribute und Optionen beschrieben, die erforderlich sind, um das Projekt Android-Bibliothek für die Veröffentlichung mit dem Android-Gradle-Plug-in (AGP) vorzubereiten. Auch wenn Sie einige dieser Eigenschaften bereits beim Erstellen der Bibliothek festgelegt haben, sollten Sie sich die folgenden Hinweise zur Optimierung Ihrer Einstellungen ansehen.

Namespace auswählen

Android-Bibliotheken müssen einen Namespace deklarieren, damit beim Kompilieren ihrer Ressourcen eine eindeutige R-Klasse generiert werden kann. Dieser Namespace sollte genau mit dem Stammklassenpaket der Bibliothek übereinstimmen, um Verwechslungen zu vermeiden, wenn Nutzer reguläre Klassen aus der Bibliothek und deren R-Klasse importieren.

Ab AGP 7.0 können Sie den Namespace in der build.gradle-Datei der App festlegen, wie im folgenden Codebeispiel gezeigt:

Groovy

android {
  namespace = 'com.example.library'
}

Kotlin

android {
  namespace = "com.example.library"
}

Der Namespace ist eine für Entwickler sichtbare Eigenschaft der Bibliothek. Sie hat nichts mit der Anwendungsidentität zu tun, die mit der Property applicationId festgelegt wird.

In früheren Versionen von AGP konnten sowohl das Attribut applicationId (für eine App) als auch das Attribut namespace (für eine Bibliothek) mit dem Attribut package des Manifests festgelegt werden, was zu Verwirrung geführt hat.

minSdkVersion-Wert auswählen

Die Auswahl eines minSdkVersion für deine Mediathek ist ein wichtiger Aspekt beim Veröffentlichen deiner Mediathek. minSdkVersion sollte die Mindestversion von Android widerspiegeln, die von deinem Code unterstützt wird.

Beachten Sie bei der Auswahl eines minSdkVersions Folgendes:

  • Wenn Sie einen niedrigen minSdkVersion auswählen, kann Ihre Bibliothek in der Regel breiter verteilt werden.

    Der Code einer Bibliothek wird in der Regel nur ausgeführt, wenn die App ihn explizit aufruft. Eine App kann weiterhin auf einer Android-Version ausgeführt werden, die niedriger ist, als aufgrund einer Bibliotheksabhängigkeit erforderlich ist – wenn die Bibliothek für die Hauptfunktion der App nicht unbedingt erforderlich ist. Dazu müssen vor dem Aufrufen der Bibliothek Laufzeitprüfungen durchgeführt werden. Legen Sie daher den Wert für minSdkVersion Ihrer Bibliothek so niedrig fest, dass sie in Apps eingebettet und nach Möglichkeit aufgerufen werden kann, um mehr Nutzer zu erreichen.

  • Wenn Sie für minSdkVersion einen hohen Wert auswählen, können Anwendungen die Bibliothek möglicherweise nicht einschließen.

    Die Manifestzusammenführung, ein Schritt in AGP, bei dem Manifestdateien aus der Anwendung und ihren Abhängigkeiten zusammengeführt werden, erzwingt, dass keine Abhängigkeiten einen höheren minSdkVersion als die Anwendung haben.

  • Wenn du einen hohen Wert für minSdkVersion auswählst, werden App-Entwickler möglicherweise aufgefordert, die Sicherheitschecks für die Manifestzusammenführung zu deaktivieren, was später im Build-Prozess zu Problemen führt.

    Da die Manifest-Dateizusammenführung verhindert, dass App-Projekte Bibliotheken mit einer höheren minSdkVersion als die App selbst enthalten, können App-Entwickler die Sicherheitsprüfungen der Manifest-Dateizusammenführung deaktivieren, um Buildfehler zu minimieren. Dies birgt jedoch das Risiko echter Inkompatibilitätsprobleme.

  • Die Auswahl eines hohen minSdkVersion kann in Sonderfällen erforderlich sein, wenn das Manifest einer Bibliothek einen Broadcast-Empfänger oder einen anderen Mechanismus enthält, durch den der Code automatisch ausgelöst wird.

    In diesen Fällen kann der Code ausgeführt werden, wenn Sie eine hohe minSdkVersion auswählen. Alternativ können Sie das automatische Verhalten deaktivieren, damit die App die Ausführung der Bibliothek nach den entsprechenden Prüfungen aktivieren kann.

Wenn Sie das Einbetten in Apps zulassen möchten, verwenden Sie die Anmerkung RequiresApi in Ihrer Bibliothek, um die Aufrufer darauf hinzuweisen, dass sie Laufzeitprüfungen durchführen müssen. AndroidLint verwendet die RequiresApi-Informationen für seine Prüfungen. Weitere Informationen zur Verwendung von Anmerkungen zum Optimieren Ihres API-Codes und Ihrer APIs finden Sie unter Codeprüfung mit Anmerkungen verbessern.

Metadaten für automatisch angewendete Empfehlungen einrichten

Eine Android-Bibliothek wird in Form einer Android-Archivdatei (AAR) verpackt. AAR-Metadaten bestehen aus Eigenschaften, die das Verwenden von Bibliotheken durch AGP unterstützen. Wenn Ihre Bibliothek von einer inkompatiblen Konfiguration verwendet wird und AAR-Metadaten eingerichtet sind, wird Nutzern eine Fehlermeldung angezeigt, die ihnen bei der Behebung des Problems helfen soll.

Wert für „minCompileSdk“ auswählen

Ab Version 4.1 unterstützt AGP minCompileSdk. Dies gibt den minimalen compileSdk an, der von verwendenden Projekten verwendet werden kann. Wenn Ihre Bibliothek Manifesteinträge oder Ressourcen enthält, die neuere Plattformattribute verwenden, müssen Sie diesen Wert festlegen.

Der Wert minCompileSdk kann in den Blöcken defaultConfig{}, productFlavors{} und buildTypes{} in der Datei build.gradle auf Modulebene festgelegt werden:

Cool

android {
  defaultConfig {
    aarMetadata {
      minCompileSdk = 29
    }
  }
  productFlavors {
    foo {
      ...
      aarMetadata {
        minCompileSdk = 30
      }
    }
  }
}

Kotlin

android {
  defaultConfig {
    aarMetadata {
      minCompileSdk = 29
    }
  }
  productFlavors {
    register("foo") {
      ...
      aarMetadata {
        minCompileSdk = 30
      }
    }
  }
}

Wenn Sie minCompileSdk an mehreren Stellen festlegen, priorisiert Gradle die Speicherorte der Einstellungen während des Build-Prozesses:

  1. buildTypes{}

  2. productFlavors{}

  3. defaultConfig{}

Im vorherigen Beispiel, in dem minCompileSdk sowohl in defaultConfig{} als auch in productFlavors{} definiert ist, hat productFlavors{} Priorität und minCompileSdk wird auf 30 gesetzt.

Weitere Informationen dazu, wie Gradle Einstellungen priorisiert, wenn Code und Ressourcen kombiniert werden, finden Sie unter Mit Quellsätzen erstellen.

Test-Fixtures aktivieren

Test-Fixtures werden häufig verwendet, um den zu testenden Code einzurichten oder die Tests einer Komponente zu vereinfachen. Ab Version 7.1 können mit AGP nicht nur Test-Fixtures für Anwendungs- und dynamische Feature-Projekte, sondern auch für Bibliotheksprojekte erstellt werden.

Wenn Sie eine Bibliothek für andere veröffentlichen, sollten Sie Test-Fixtures für Ihre API erstellen. Test-Fixtures können in der Datei build.gradle auf Modulebene aktiviert werden:

Groovy

android {
  testFixtures {
    enable = true
  }
}

Kotlin

android {
  testFixtures {
    enable = true
  }
}

Wenn Sie Test-Fixierungen aktivieren, erstellt Gradle automatisch einen src/testFixtures-Quellsatz, in dem Sie Test-Fixierungen schreiben können.

Weitere Informationen finden Sie in der Gradle-Dokumentation zur Verwendung von Test-Fixtures.