Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ANT V2: New major version of the ANT task #20634

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ Tasks/AndroidSigningV3/ @microsoft/akvelon-build-task-team

Tasks/ANTV1/ @microsoft/akvelon-build-task-team

Tasks/ANTV2/ @microsoft/akvelon-build-task-team

Tasks/AppCenterDistributeV1/ @imenkov @lucen-ms @DergachevE

Tasks/AppCenterDistributeV2/ @imenkov @lucen-ms @DergachevE
Expand Down
31 changes: 31 additions & 0 deletions Tasks/ANTV2/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Build your code using Ant in Azure Pipelines

### Parameters for Ant build task are explained below

- **Ant Build File :** This is a Required field. Provide relative path from the repository root to the Ant build file. To know more [click here](https://ant.apache.org/manual/using.html#buildfile)

- **Options :** Provide any options to pass to the Ant command line. You can provide your own properties (for example, `-DmyProperty=myPropertyValue`) and also use built-in variables (for example, `-DcollectionId=$(system.collectionId)`). Alternatively, the built-in variables are already set as environment variables during the build and can be passed directly (for example, `-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%)` To know more [click here](https://ant.apache.org/manual/running.html#options)

- **Target(s) :** Provide The task(s) for Ant to execute for this build. To know more [click here](https://ant.apache.org/manual/targets.html#targets)

#### JUnit Test Results
Use the next three options to manage your JUnit test results in Azure Pipelines

- **Publish to Azure Pipelines/TFS :** Select this option to publish JUnit Test results produced by the Ant build to Azure Pipelines/TFS. Each test result file matching `Test Results Files` will be published as a test run in Azure Pipelines.

- **Test Results Files :** This option will appear if you select the above option. Here, provide Test results files path. Wildcards can be used. For example, `**/TEST-*.xml` for all xml files whose name starts with `TEST-."`

- **Test Run Title :** This option will appear if you select the `Publish to Azure Pipelines/TFS` option. Here provide a name for the Test Run

#### Advanced
Use the next options to manage your `ANT_HOME` and `JAVA_HOME` attributes

- **Set ANT_HOME Path :** If set, overrides any existing `ANT_HOME` environment variable with the given path.

- **Set JAVA_HOME by :** Select to set `JAVA_HOME` either by providing a path or let Azure Pipelines set the `JAVA_HOME` based on JDK version choosen. By default it is set to `JDK Version`

- **JDK Version/Path :** Here provide the PATH to `JAVA_HOME` if you want to set it by path or select the appropriate JDK version.

- **JDK Architecture :** Select the approriate JDK Architecture. By default it is set to `x86`

**We are discontinuing the support of automated Code Coverage report generation for Ant projects starting Sprint 107 deployment of Azure Pipelines and for Team Foundation Server “15”. Please enable Code Coverage in your Ant build.xml file manually.**
34 changes: 34 additions & 0 deletions Tasks/ANTV2/Strings/resources.resjson/de-DE/resources.resjson
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"loc.friendlyName": "Ant",
"loc.helpMarkDown": "[Weitere Informationen zu dieser Aufgabe](https://go.microsoft.com/fwlink/?LinkID=613718) oder [Ant-Dokumentation anzeigen](http://ant.apache.org/)",
"loc.description": "Mit Apache Ant erstellen",
"loc.instanceNameFormat": "Ant $(options) $(antBuildFile)",
"loc.group.displayName.junitTestResults": "JUnit-Testergebnisse",
"loc.group.displayName.advanced": "Erweitert",
"loc.input.label.antBuildFile": "Ant-Builddatei",
"loc.input.help.antBuildFile": "Der relative Pfad vom Repositorystamm zur Ant-Builddatei.",
"loc.input.label.options": "Optionen",
"loc.input.help.options": "Geben Sie die Optionen an, die an die Ant-Befehlszeile übergeben werden sollen. Sie können Ihre eigenen Eigenschaften angeben (z. B. \"***-DmyProperty=meinEigenschaftenWert***\") und auch integrierte Variablen verwenden (z. B. \"***-DcollectionId=$(system.collectionId)***\"). Alternativ werden die integrierten Variablen bereits als Umgebungsvariablen während des Builds festgelegt und können direkt übergeben werden (z. B. \"***-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%***\").",
"loc.input.label.targets": "Ziel(e)",
"loc.input.help.targets": "Eine optionale, durch Leerzeichen getrennte Liste der zu erstellenden Ziele. Wenn keine Angabe erfolgt, wird das \"Standardziel\" verwendet. Wenn kein \"Standardziel\" definiert ist, wird Ant 1.6.0 verwendet, und alle Tasks auf oberster Ebene werden später erstellt.",
"loc.input.label.publishJUnitResults": "In Azure Pipelines veröffentlichen",
"loc.input.help.publishJUnitResults": "Wählen Sie diese Option aus, um vom Ant-Build generierte JUnit-Testergebnisse in Azure Pipelines zu veröffentlichen. Jede Testergebnisdatei, die mit \"Testergebnisdateien\" übereinstimmt, wird als Testlauf in Azure Pipelines veröffentlicht.",
"loc.input.label.testResultsFiles": "Testergebnisdateien",
"loc.input.help.testResultsFiles": "Pfad der Testergebnisdateien. Platzhalter können verwendet werden ([weitere Informationen](https://go.microsoft.com/fwlink/?linkid=856077)). Beispiel: \"**/TEST-*.xml\" für alle XML-Dateien, deren Name mit \"TEST-\" beginnt.",
"loc.input.label.testRunTitle": "Testlauftitel",
"loc.input.help.testRunTitle": "Geben Sie einen Namen für den Testlauf an.",
"loc.input.label.antHomeUserInputPath": "ANT_HOME-Pfad festlegen",
"loc.input.help.antHomeUserInputPath": "Wenn festgelegt, werden alle vorhandenen ANT_HOME-Umgebungsvariablen mit dem angegebenen Pfad überschrieben.",
"loc.input.label.javaHomeSelection": "JAVA_HOME festlegen durch",
"loc.input.help.javaHomeSelection": "Legt JAVA_HOME durch Auswählen einer JDK-Version fest, die während der Erstellung von Builds oder durch manuelles Eingeben eines JDK-Pfads ermittelt wird.",
"loc.input.label.jdkVersion": "JDK-Version",
"loc.input.help.jdkVersion": "Versucht, den Pfad zur ausgewählten JDK-Version zu ermitteln und JAVA_HOME entsprechend festzulegen.",
"loc.input.label.jdkUserInputPath": "JDK-Pfad",
"loc.input.help.jdkUserInputPath": "Legt JAVA_HOME auf den angegebenen Pfad fest.",
"loc.input.label.jdkArchitecture": "JDK-Architektur",
"loc.input.help.jdkArchitecture": "Geben Sie optional die JDK-Architektur an (x86, x64).",
"loc.messages.LocateJVMBasedOnVersionAndArch": "JAVA_HOME für Java %s %s finden",
"loc.messages.UnsupportedJdkWarning": "JDK 9 und JDK 10 werden nicht unterstützt. Wechseln Sie in Ihrem Projekt und Ihrer Pipeline zu einer neueren Version. Es wird versucht, die Erstellung mit JDK 11 durchzuführen...",
"loc.messages.FailedToLocateSpecifiedJVM": "Die angegebene JDK-Version wurde nicht gefunden. Stellen Sie sicher, dass die angegebene JDK-Version auf dem Agent installiert und die Umgebungsvariable \"%s\" vorhanden und auf den Speicherort eines entsprechenden JDK festgelegt ist. Sie können auch die Aufgabe [Installer für Java-Tools](https://go.microsoft.com/fwlink/?linkid=875287) verwenden, um das gewünschte JDK zu installieren.",
"loc.messages.NoTestResults": "Es wurden keine Testergebnisdateien gefunden, die mit %s übereinstimmen. Das Veröffentlichen von JUnit-Testergebnissen wird daher übersprungen."
}
34 changes: 34 additions & 0 deletions Tasks/ANTV2/Strings/resources.resjson/en-US/resources.resjson
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"loc.friendlyName": "Ant",
"loc.helpMarkDown": "[Learn more about this task](https://go.microsoft.com/fwlink/?LinkID=613718) or [see the Ant documentation](http://ant.apache.org/)",
"loc.description": "Build with Apache Ant",
"loc.instanceNameFormat": "Ant $(options) $(antBuildFile)",
"loc.group.displayName.junitTestResults": "JUnit Test Results",
"loc.group.displayName.advanced": "Advanced",
"loc.input.label.antBuildFile": "Ant build file",
"loc.input.help.antBuildFile": "Relative path from the repository root to the Ant build file.",
"loc.input.label.options": "Options",
"loc.input.help.options": "Provide any options to pass to the Ant command line. You can provide your own properties (for example, ***-DmyProperty=myPropertyValue***) and also use built-in variables (for example, ***-DcollectionId=$(system.collectionId)***). Alternatively, the built-in variables are already set as environment variables during the build and can be passed directly (for example, ***-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%***).",
"loc.input.label.targets": "Target(s)",
"loc.input.help.targets": "An optional, space-separated list of targets to build. If not specified, the `default` target will be used. If no `default` target is defined, Ant 1.6.0 and later will build all top-level tasks.",
"loc.input.label.publishJUnitResults": "Publish to Azure Pipelines",
"loc.input.help.publishJUnitResults": "Select this option to publish JUnit test results produced by the Ant build to Azure Pipelines. Each test results file matching `Test Results Files` will be published as a test run in Azure Pipelines.",
"loc.input.label.testResultsFiles": "Test results files",
"loc.input.help.testResultsFiles": "Test results files path. Wildcards can be used ([more information](https://go.microsoft.com/fwlink/?linkid=856077)). For example, `**/TEST-*.xml` for all XML files whose name starts with TEST-.",
"loc.input.label.testRunTitle": "Test run title",
"loc.input.help.testRunTitle": "Provide a name for the test run.",
"loc.input.label.antHomeUserInputPath": "Set ANT_HOME path",
"loc.input.help.antHomeUserInputPath": "If set, overrides any existing ANT_HOME environment variable with the given path.",
"loc.input.label.javaHomeSelection": "Set JAVA_HOME by",
"loc.input.help.javaHomeSelection": "Sets JAVA_HOME either by selecting a JDK version that will be discovered during builds or by manually entering a JDK path.",
"loc.input.label.jdkVersion": "JDK version",
"loc.input.help.jdkVersion": "Will attempt to discover the path to the selected JDK version and set JAVA_HOME accordingly.",
"loc.input.label.jdkUserInputPath": "JDK path",
"loc.input.help.jdkUserInputPath": "Sets JAVA_HOME to the given path.",
"loc.input.label.jdkArchitecture": "JDK architecture",
"loc.input.help.jdkArchitecture": "Optionally supply the architecture (x86, x64) of the JDK.",
"loc.messages.LocateJVMBasedOnVersionAndArch": "Locate JAVA_HOME for Java %s %s",
"loc.messages.UnsupportedJdkWarning": "JDK 9 and JDK 10 are out of support. Please switch to a later version in your project and pipeline. Attempting to build with JDK 11...",
"loc.messages.FailedToLocateSpecifiedJVM": "Failed to find the specified JDK version. Please ensure the specified JDK version is installed on the agent and the environment variable '%s' exists and is set to the location of a corresponding JDK or use the [Java Tool Installer](https://go.microsoft.com/fwlink/?linkid=875287) task to install the desired JDK.",
"loc.messages.NoTestResults": "No test result files matching %s were found, so publishing JUnit test results is being skipped."
}
34 changes: 34 additions & 0 deletions Tasks/ANTV2/Strings/resources.resjson/es-ES/resources.resjson
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"loc.friendlyName": "Ant",
"loc.helpMarkDown": "[Obtener más información acerca de esta tarea](https://go.microsoft.com/fwlink/?LinkID=613718) o [consultar la documentación de Ant](http://ant.apache.org/)",
"loc.description": "Compilar con Apache Ant",
"loc.instanceNameFormat": "Ant $(options) $(antBuildFile)",
"loc.group.displayName.junitTestResults": "Resultados de pruebas JUnit",
"loc.group.displayName.advanced": "Avanzado",
"loc.input.label.antBuildFile": "Archivo de compilación de Ant",
"loc.input.help.antBuildFile": "Ruta de acceso relativa de la raíz del repositorio al archivo de compilación de Ant.",
"loc.input.label.options": "Opciones",
"loc.input.help.options": "Proporcione las opciones que se van a pasar a la línea de comandos de Ant. Puede proporcionar sus propiedades (por ejemplo, ***-DmyProperty=myPropertyValue***) y también usar variables integradas (por ejemplo, ***-DcollectionId=$(system.collectionId)***). Puede que las variables integradas ya se hayan establecido como variables de entorno durante la compilación y se puedan pasar directamente (por ejemplo, ***-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%***).",
"loc.input.label.targets": "Destinos",
"loc.input.help.targets": "Una lista opcional y separada por espacios de los destinos que se van a compilar. Si no se especifica, se usará el destino \"predeterminado\". Si no se define ningún destino \"predeterminado\", Ant 1.6.0 y las versiones posteriores compilarán todas las tareas de nivel superior.",
"loc.input.label.publishJUnitResults": "Publicar en Azure Pipelines",
"loc.input.help.publishJUnitResults": "Seleccione esta opción para publicar los resultados de pruebas JUnit generados por la compilación de Ant en Azure Pipelines. Cada archivo de resultados de pruebas que coincida con \"Archivos de resultados de pruebas\" se publicará como una serie de pruebas en Azure Pipelines.",
"loc.input.label.testResultsFiles": "Archivos de resultados de pruebas",
"loc.input.help.testResultsFiles": "Ruta de acceso de los archivos de resultados de pruebas. Puede usar caracteres comodín ([más información](https://go.microsoft.com/fwlink/?linkid=856077)). Por ejemplo, \"**\\*TEST-*.xml\" para todos los archivos XML cuyos nombres empiecen por TEST-.",
"loc.input.label.testRunTitle": "Título de la serie de pruebas",
"loc.input.help.testRunTitle": "Asigne un nombre a la serie de pruebas.",
"loc.input.label.antHomeUserInputPath": "Establecer la ruta ANT_HOME",
"loc.input.help.antHomeUserInputPath": "Si se establece, reemplaza cualquier variable de entorno ANT_HOME existente por la ruta de acceso dada.",
"loc.input.label.javaHomeSelection": "Establecer JAVA_HOME por",
"loc.input.help.javaHomeSelection": "Establece JAVA_HOME seleccionando una versión de JDK que se detectará durante las compilaciones o especificando manualmente una ruta de acceso del JDK.",
"loc.input.label.jdkVersion": "Versión de JDK",
"loc.input.help.jdkVersion": "Se tratará de hallar la ruta de acceso a la versión de JDK seleccionada y establecer JAVA_HOME según sea el caso.",
"loc.input.label.jdkUserInputPath": "Ruta de acceso de JDK",
"loc.input.help.jdkUserInputPath": "Establece JAVA_HOME en la ruta de acceso especificada.",
"loc.input.label.jdkArchitecture": "Arquitectura JDK",
"loc.input.help.jdkArchitecture": "Indique opcionalmente la arquitectura (x86, x64) del JDK.",
"loc.messages.LocateJVMBasedOnVersionAndArch": "Buscar JAVA_HOME para Java %s %s",
"loc.messages.UnsupportedJdkWarning": "JDK 9 y JDK 10 no tienen soporte técnico. Cambie a una versión posterior del proyecto y la canalización. Intentando compilar con JDK 11...",
"loc.messages.FailedToLocateSpecifiedJVM": "No se encontró la versión de JDK especificada. Asegúrese de que dicha versión está instalada en el agente y de que la variable de entorno \"%s\" existe y está establecida en la ubicación de un JDK correspondiente. En caso contrario, use la tarea de [Instalador de herramientas de Java](https://go.microsoft.com/fwlink/?linkid=875287) para instalar el JDK deseado.",
"loc.messages.NoTestResults": "No se encontraron archivos de resultados de pruebas que coincidan con %s, por lo que se omite la publicación de los resultados de las pruebas JUnit."
}
34 changes: 34 additions & 0 deletions Tasks/ANTV2/Strings/resources.resjson/fr-FR/resources.resjson
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"loc.friendlyName": "Ant",
"loc.helpMarkDown": "[En savoir plus sur cette tâche](https://go.microsoft.com/fwlink/?LinkID=613718) ou [consulter la documentation d'Ant](http://ant.apache.org/)",
"loc.description": "Générer avec Apache Ant",
"loc.instanceNameFormat": "Ant $(options) $(antBuildFile)",
"loc.group.displayName.junitTestResults": "Résultats du test JUnit",
"loc.group.displayName.advanced": "Avancé",
"loc.input.label.antBuildFile": "Fichier de build Ant",
"loc.input.help.antBuildFile": "Chemin relatif de la racine de dépôt au fichier de build Ant.",
"loc.input.label.options": "Options",
"loc.input.help.options": "Indiquez les options à passer à la ligne de commande Ant. Vous pouvez fournir vos propres propriétés (par exemple ***-DmyProperty=myPropertyValue***), et utiliser les variables intégrées (par exemple ***-DcollectionId=$(system.collectionId)***). Sinon, les variables intégrées sont déjà définies comme variables d'environnement durant la génération et peuvent être passées directement (par exemple ***-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%***).",
"loc.input.label.targets": "Cible(s)",
"loc.input.help.targets": "Liste facultative de cibles à générer, séparées par des espaces. Si rien n'est spécifié, la cible 'default' est utilisée. Si aucune cible 'default' n'est définie, Ant 1.6.0 ou ultérieur génère des tâches qui sont toutes de niveau supérieur.",
"loc.input.label.publishJUnitResults": "Publier sur Azure Pipelines",
"loc.input.help.publishJUnitResults": "Sélectionnez cette option pour publier les résultats des tests JUnit produits par la build Ant sur Azure Pipelines. Chaque fichier de résultats des tests correspondant à 'Fichiers de résultats des tests' est publié en tant que série de tests dans Azure Pipelines.",
"loc.input.label.testResultsFiles": "Fichiers de résultats des tests",
"loc.input.help.testResultsFiles": "Chemin des fichiers de résultats des tests. Les caractères génériques sont autorisés. ([Plus d'informations](https://go.microsoft.com/fwlink/?linkid=856077)). Par exemple, '**/TEST-*.xml' pour tous les fichiers XML dont le nom commence par TEST-.",
"loc.input.label.testRunTitle": "Titre de la série de tests",
"loc.input.help.testRunTitle": "Indiquez le nom de la série de tests.",
"loc.input.label.antHomeUserInputPath": "Définir le chemin de ANT_HOME",
"loc.input.help.antHomeUserInputPath": "Si elle est définie, cette valeur remplace les variables d'environnement ANT_HOME existantes par le chemin spécifié.",
"loc.input.label.javaHomeSelection": "Définir JAVA_HOME par",
"loc.input.help.javaHomeSelection": "Définit JAVA_HOME en sélectionnant une version de JDK qui sera découverte au moment des builds ou en tapant le chemin de JDK.",
"loc.input.label.jdkVersion": "Version du kit JDK",
"loc.input.help.jdkVersion": "Essaiera de découvrir le chemin d'accès à la version du JDK sélectionné et définira JAVA_HOME en conséquence.",
"loc.input.label.jdkUserInputPath": "Chemin du kit JDK",
"loc.input.help.jdkUserInputPath": "Définissez JAVA_HOME sur le chemin d'accès indiqué.",
"loc.input.label.jdkArchitecture": "Architecture du kit JDK",
"loc.input.help.jdkArchitecture": "Indiquez éventuellement l'architecture (x86, x64) du JDK.",
"loc.messages.LocateJVMBasedOnVersionAndArch": "Localiser JAVA_HOME pour Java %s %s",
"loc.messages.UnsupportedJdkWarning": "JDK 9 et JDK 10 ne sont plus pris en charge. Passez à une version plus récente de votre projet et de votre pipeline. Tentative de génération avec JDK 11...",
"loc.messages.FailedToLocateSpecifiedJVM": "Échec de la localisation de la version spécifiée du kit JDK. Vérifiez que la version spécifiée du kit JDK est installée sur l'agent, que la variable d'environnement '%s' existe et que sa valeur correspond à l'emplacement d'un kit JDK correspondant. Sinon, utilisez la tâche [Programme d'installation de l'outil Java] (https://go.microsoft.com/fwlink/?linkid=875287) pour installer le kit JDK souhaité.",
"loc.messages.NoTestResults": "Les fichiers de résultats des tests correspondant à %s sont introuvables. La publication des résultats des tests JUnit est ignorée."
}
Loading