From 56285d6bbd4f42933ce82c533accebe1fbba65e8 Mon Sep 17 00:00:00 2001 From: boztopuz Date: Tue, 12 Nov 2024 14:26:00 +0300 Subject: [PATCH 01/10] Initially fixed for wf step templates --- .../android-build-for-ui-testing.md | 6 +++--- .../android-specific-workflow-steps/android-build.md | 6 +++--- .../android-dependency-report.md | 2 +- .../android-specific-workflow-steps/android-sign.md | 8 ++++---- .../android-unit-tests.md | 2 +- .../app-center-android-distribution.md | 4 ++-- .../app-post-processor.md | 6 +++--- .../appdome-build-to-secure-for-android.md | 12 ++++++------ .../appsweep-mobile-security-testing.md | 4 ++-- .../azure-bot-for-detekt-report.md | 2 +- .../browserstack-app-automate-espresso.md | 4 ++-- .../bundle-universal-apk.md | 6 +++--- .../android-specific-workflow-steps/detekt.md | 4 ++-- .../firebase-test-lab.md | 2 +- .../android-specific-workflow-steps/lint.md | 2 +- .../post-processor.md | 8 ++++---- .../test-reports-for-android.md | 6 +++--- .../wait-for-android-emulator.md | 4 ++-- .../common-workflow-steps/active-ssh-private-key.md | 6 +++--- .../common-workflow-steps/add-badge-app-icon.md | 2 +- .../aws-device-farm-and-deploy.md | 12 ++++++------ docs/workflows/common-workflow-steps/azure-board.md | 2 +- docs/workflows/common-workflow-steps/danger.md | 4 ++-- .../data-theorem-mobile-secure.md | 4 ---- docs/workflows/common-workflow-steps/fastlane.md | 2 +- .../firebase-app-distribution.md | 6 +++--- docs/workflows/common-workflow-steps/git-clone.md | 2 +- .../common-workflow-steps/marathon-cloud.md | 4 ++-- .../common-workflow-steps/publish-release-notes.md | 6 ++---- .../common-workflow-steps/repeato-test-runner.md | 6 +++--- .../common-workflow-steps/snyk-scan-security.md | 4 ++-- docs/workflows/common-workflow-steps/testinium.md | 6 +++--- .../upload-files-to-amazon-s3.md | 2 +- .../flutter-build-for-android.md | 4 ++-- .../flutter-build-for-web.md | 2 +- .../flutter-specific-workflow-steps/flutter-test.md | 2 +- .../appcenter-ios-distribution.md | 8 ++++---- .../appdome-build-to-secure-for-ios.md | 8 ++++---- .../audit-permission-change.md | 2 +- .../browserstack-app-automation.md | 2 +- .../ios-specific-workflow-steps/carthage.md | 4 ++-- .../cocoapods-deintegrate.md | 2 +- .../ios-specific-workflow-steps/cocoapods-install.md | 2 +- .../convert-xcresult-to-xml-html.md | 2 +- .../install-certificates-provisions.md | 4 ++-- .../workflows/ios-specific-workflow-steps/slather.md | 8 ++++---- .../ios-specific-workflow-steps/swiftlint.md | 8 ++++---- .../test-reports-for-ios.md | 4 ++-- .../ios-specific-workflow-steps/tuist-commands.md | 4 ++-- .../ios-specific-workflow-steps/tuist-install.md | 2 +- .../xcodebuild-for-devices.md | 2 +- .../xcodebuild-for-ios-simulator.md | 2 +- .../xcodebuild-for-testing.md | 12 ++++++------ .../xcodebuild-for-unit-and-ui-test.md | 2 +- .../app-center-code-push.md | 2 +- 55 files changed, 119 insertions(+), 125 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md index 62549c231..cedfcd9c3 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md +++ b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md @@ -16,7 +16,7 @@ The workflow steps that need to be executed before running the **Android Build f | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Android Build for UI Testing** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Build for UI Testing** step. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Android Build for UI Testing** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Build for UI Testing** step. | :::caution If you're updating the version via Appcircle, ensure that the following step comes before the **Android Build for UI Testing** step: @@ -57,8 +57,8 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | ------------------- | -------------------------------------------------------------------------------------------------------------------- | -| `$AC_APK_PATH` | Path for the generated **APK** file. This path will be created after the **Android Build for UI Testing** step runs. | -| `$AC_TEST_APK_PATH` | Path for the generated `*androidTest.apk` file. This output can be utilized wherever necessary for UI testing. | +| `AC_APK_PATH` | Path for the generated **APK** file. This path will be created after the **Android Build for UI Testing** step runs. | +| `AC_TEST_APK_PATH` | Path for the generated `*androidTest.apk` file. This output can be utilized wherever necessary for UI testing. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/android-specific-workflow-steps/android-build.md b/docs/workflows/android-specific-workflow-steps/android-build.md index 617bcf5d6..7fe18e114 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build.md +++ b/docs/workflows/android-specific-workflow-steps/android-build.md @@ -16,7 +16,7 @@ The workflow steps that need to be executed before running the **Android Build** | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Git Clone](/workflows/common-workflow-steps/#git-clone) | To initiate the Android build process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the Git Clone step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | +| [Git Clone](/workflows/common-workflow-steps/#git-clone) | To initiate the Android build process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the Git Clone step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | @@ -55,8 +55,8 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | -------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| `$AC_APK_PATH` | Path for the generated **APK** file. This path will be created after the **Android Build** step runs. | -| `$AC_AAB_PATH` | Path for the generated **AAB** file. This path will be created after the Android Build step runs and when `AAB` is selected. | +| `AC_APK_PATH` | Path for the generated **APK** file. This path will be created after the **Android Build** step runs. | +| `AC_AAB_PATH` | Path for the generated **AAB** file. This path will be created after the Android Build step runs and when `AAB` is selected. | The resulting files will be either APK or AAB, depending on whether you choose the Android App in the project [Configuration](/build/build-process-management/build-profile-configuration). diff --git a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md index ae3b1d1ae..e2aea4360 100644 --- a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md +++ b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md @@ -41,7 +41,7 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | ------------------------------------ | ---------------------------------------------------------------------- | -| `$AC_ANDROID_DEPENDENCY_REPORT_PATH` | Specifies the path where the Android dependency report file is stored. | +| `AC_ANDROID_DEPENDENCY_REPORT_PATH` | Specifies the path where the Android dependency report file is stored. | :::danger If you wish to review or download the Android Dependencies Report, you can find them directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts). To do this, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step follows the **Android Dependency Report** workflow step. diff --git a/docs/workflows/android-specific-workflow-steps/android-sign.md b/docs/workflows/android-specific-workflow-steps/android-sign.md index 3d788d51e..7e18cb2ee 100644 --- a/docs/workflows/android-specific-workflow-steps/android-sign.md +++ b/docs/workflows/android-specific-workflow-steps/android-sign.md @@ -19,8 +19,8 @@ The workflow steps that need to be executed before running the **Android Build** | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | -| [Android Build](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | +| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | :::caution If a step other than the **Android Build** step is used to build an app, then the **Android Sign** step depends on this step. @@ -54,8 +54,8 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | |------------------------|---------------------------------------------| -| `$AC_SIGNED_APK_PATH` | Path for the signed *APK* file output. If an *APK* file is provided as input, the signed app will also be in *APK* format. | -| `$AC_SIGNED_AAB_PATH` | Path for the signed App Bundle file output. If an *AAB* file is provided as input, the signed app will also be in *AAB* format. | +| `AC_SIGNED_APK_PATH` | Path for the signed *APK* file output. If an *APK* file is provided as input, the signed app will also be in *APK* format. | +| `AC_SIGNED_AAB_PATH` | Path for the signed App Bundle file output. If an *AAB* file is provided as input, the signed app will also be in *AAB* format. | :::tip If both input value types (*AAB* and *APK*) are provided, the same type of signed app will be generated for both. diff --git a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md index 9a1705475..bacb05d74 100644 --- a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md +++ b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md @@ -47,7 +47,7 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | ---------------------- | -------------------------------------------------------------- | -| `$AC_TEST_RESULT_PATH` | Specifies the directory where your JUnit XML report is stored. | +| `AC_TEST_RESULT_PATH` | Specifies the directory where your JUnit XML report is stored. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index c8c4cb9f2..ddd9fb224 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -29,8 +29,8 @@ The workflow steps that need to be executed before running the **App Center Andr | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [Android Build](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the Android Build (or alternative build steps). | -| [Android Sign](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | +| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the Android Build (or alternative build steps). | +| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::danger If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **App Center Android Distribute** step depends on this step. diff --git a/docs/workflows/android-specific-workflow-steps/app-post-processor.md b/docs/workflows/android-specific-workflow-steps/app-post-processor.md index 5f54d0514..06b3af247 100644 --- a/docs/workflows/android-specific-workflow-steps/app-post-processor.md +++ b/docs/workflows/android-specific-workflow-steps/app-post-processor.md @@ -18,9 +18,9 @@ The workflow steps that need to be executed before running the **Android App Pos | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | -| [Android Build](/workflows/android-specific-workflow-steps/android-build) | To process Android output, these outputs must be obtained from the build step. | -| [Android Sign](/workflows/android-specific-workflow-steps/android-sign) | If a signed app is created, this step needs to be run beforehand to process this output. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | To process Android output, these outputs must be obtained from the build step. | +| [**Android Sign**](/workflows/android-specific-workflow-steps/android-sign) | If a signed app is created, this step needs to be run beforehand to process this output. | diff --git a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md index 1e226a99a..3c2068190 100644 --- a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md @@ -20,8 +20,8 @@ The workflow steps that need to be executed before running the **Appdome Build-2 | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [Android Build](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | -| [Android Sign](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | +| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | +| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::danger If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Appdome Build-2Secure for Android** step depends on this step. @@ -59,10 +59,10 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `$AC_APPDOME_SECURED_APK_PATH` | Specified path of the secured APK file produced by **Appdome Build-2Secure**. This is available when the `Signing Method` is set to `On-Appdome` or `Private-Signing`. | -| `$AC_APPDOME_SECURED_AAB_PATH` | Specified path of the secured AAB file produced by **Appdome Build-2Secure**. This is available when the `Signing Method` is set to `On-Appdome` or `Private-Signing`. | -| `$AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | Specified path of the `.sh` sign script file produced by **Appdome Build-2Secure**. This is available when the `Signing Method` is set to `Auto-Dev-Signing`. | -| `$AC_APPDOME_CERTIFICATE_PATH` | Specified path of the [**_Certified Secure_**](https://www.appdome.com/certified-secure-mobile-devsecops-certification/) certificate produced by **Appdome Build-2Secure** for your app is provided as a PDF file. | +| `AC_APPDOME_SECURED_APK_PATH` | Specified path of the secured APK file produced by **Appdome Build-2Secure**. This is available when the `Signing Method` is set to `On-Appdome` or `Private-Signing`. | +| `AC_APPDOME_SECURED_AAB_PATH` | Specified path of the secured AAB file produced by **Appdome Build-2Secure**. This is available when the `Signing Method` is set to `On-Appdome` or `Private-Signing`. | +| `AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | Specified path of the `.sh` sign script file produced by **Appdome Build-2Secure**. This is available when the `Signing Method` is set to `Auto-Dev-Signing`. | +| `AC_APPDOME_CERTIFICATE_PATH` | Specified path of the [**_Certified Secure_**](https://www.appdome.com/certified-secure-mobile-devsecops-certification/) certificate produced by **Appdome Build-2Secure** for your app is provided as a PDF file. | --- diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index f050e4b1a..f295831a2 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -18,7 +18,7 @@ The workflow steps that need to be executed before running the **AppSweep Mobile | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The **AppSweep Mobile Security Testing** step requires the repository to be cloned from the Git provider before it can function properly. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The **AppSweep Mobile Security Testing** step requires the repository to be cloned from the Git provider before it can function properly. | @@ -46,7 +46,7 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | ------------------ | ------------------------------------------------------------- | -| `$AC_APPSWEEP_URL` | A direct link to the scan results is on the AppSweep website. | +| `AC_APPSWEEP_URL` | A direct link to the scan results is on the AppSweep website. | --- diff --git a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md index dd8a334a8..a17fc83d0 100644 --- a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md +++ b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md @@ -25,7 +25,7 @@ The workflow steps that need to be executed before running the **Azure DevOps Bo | Prerequisite Workflow Step | Description | |-------------------------------------------------|--------------------------------------------------| - | [Detekt](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#detekt) | In order to generate the [Detekt report](https://detekt.dev/docs/introduction/reporting/), the **Detekt** step must be executed beforehand. | + | [**Detekt**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#detekt) | In order to generate the [Detekt report](https://detekt.dev/docs/introduction/reporting/), the **Detekt** step must be executed beforehand. | diff --git a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md index 57fe9402b..a1bfd4daa 100644 --- a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md +++ b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md @@ -18,7 +18,7 @@ The workflow steps that need to be executed before running the **BrowserStack Ap | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Android Build for UI Testing](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android app outputs for processing. | +| [**Android Build for UI Testing**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android app outputs for processing. | @@ -33,7 +33,7 @@ For each component, specific input variables are required for its operation on y | `$AC_BROWSERSTACK_ACCESS_KEY` | Specifies the access key for the BrowserStack account. Refer to [BrowserStack - Authenticate Test Runs](https://www.browserstack.com/docs/automate/cypress/authentication) for more details. | Required | | `$AC_APK_PATH` | Specifies the path of the **APK** file produced in the Appcircle workflow to be sent to BrowserStack. This field is automatically populated if the **Android Build for UI Testing** step was executed in previous steps. | Required | | `$AC_TEST_APK_PATH` | Specifies the path of the **test APK** file produced in the Appcircle workflow to be sent to BrowserStack. This field is automatically populated if the **Android Build for UI Testing** step was executed in previous steps. | Required | -| `$AC_BROWSERSTACK_PAYLOAD` | Specifies the payload to be sent to BrowserStack from your Appcircle workflow.`AC_BROWSERSTACK_APP_URL` and `AC_BROWSERSTACK_TEST_URL` will be auto generated. Please refer to the [documentation](https://www.browserstack.com/docs/app-automate/api-reference/espresso/builds#execute-a-build) for more details about the payload. | Optional | +| `$AC_BROWSERSTACK_PAYLOAD` | Specifies the payload to be sent to BrowserStack from your Appcircle workflow.`$AC_BROWSERSTACK_APP_URL` and `$AC_BROWSERSTACK_TEST_URL` will be auto generated. Please refer to the [documentation](https://www.browserstack.com/docs/app-automate/api-reference/espresso/builds#execute-a-build) for more details about the payload. | Optional | | `$AC_BROWSERSTACK_TIMEOUT` | Specifies the timeout in seconds for checking the BrowserStack plan. The default value is `600`. | Required | --- diff --git a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md index b5255d90f..c6b147a33 100644 --- a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md +++ b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md @@ -18,8 +18,8 @@ The workflow steps that need to be executed before running the **Bundle Universa | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [Android Build](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | This step is necessary to generate the **AAB** app that will be converted to an **APK**. | -| [Android Sign](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | +| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | This step is necessary to generate the **AAB** app that will be converted to an **APK**. | +| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::caution If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Bundle Universal Apk** step depends on this step. @@ -48,7 +48,7 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | | --------------------- | -------------------------------- | -| `$AC_SIGNED_APK_PATH` | Path of the signed **APK** file. | +| `AC_SIGNED_APK_PATH` | Path of the signed **APK** file. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/android-specific-workflow-steps/detekt.md b/docs/workflows/android-specific-workflow-steps/detekt.md index 1cbaedbe2..e3dce2e78 100644 --- a/docs/workflows/android-specific-workflow-steps/detekt.md +++ b/docs/workflows/android-specific-workflow-steps/detekt.md @@ -18,7 +18,7 @@ Below are the prerequisite workflow steps required before running the **Detekt** | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) | The **Git Clone** step is necessary to fetch the repository before conducting code checks and must precede the **Detekt** step. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) | The **Git Clone** step is necessary to fetch the repository before conducting code checks and must precede the **Detekt** step. | @@ -33,7 +33,7 @@ Each component requires specific input variables for its operation. The input va | `$AC_DETEKT_TASK` | Specifies the name of the Detekt task. The default value is `detekt`. | Required | | `$AC_DETEKT_EXTRA_PARAMETERS` | Additional command-line parameters for Detekt. | Optional | | `$AC_DETEKT_SAVE_REPORT` | Specifies whether the Detekt report will be saved. If set to `true`, report files will be saved into the artifacts folder. The default value is `false`. | Optional | -| `$AC_DETEKT_OUTPUT_PATH` | Specifies the Detekt output path. If the `AC_DETEKT_SAVE_REPORT` input is set to `true` and this value is not defined, then `/build/reports` will be used as the default path. | Optional | +| `$AC_DETEKT_OUTPUT_PATH` | Specifies the Detekt output path. If the `$AC_DETEKT_SAVE_REPORT` input is set to `true` and this value is not defined, then `/build/reports` will be used as the default path. | Optional | :::danger diff --git a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md index a20a145ac..cf3fae5a8 100644 --- a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md +++ b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md @@ -16,7 +16,7 @@ The necessary workflow steps to execute before running the **Firebase Test Lab f | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Android Build for UI Testing](./android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android application outputs for processing. | +| [**Android Build for UI Testing**](./android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android application outputs for processing. | In addition to the steps you need to run on Appcircle, there are also adjustments you need to make on the Firebase Test Lab side. These adjustments can be made as follows: diff --git a/docs/workflows/android-specific-workflow-steps/lint.md b/docs/workflows/android-specific-workflow-steps/lint.md index b5e2074ba..ee7003b50 100644 --- a/docs/workflows/android-specific-workflow-steps/lint.md +++ b/docs/workflows/android-specific-workflow-steps/lint.md @@ -18,7 +18,7 @@ The workflow steps that need to be executed before running the **Android Lint** | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Git Clone](/workflows/common-workflow-steps/git-clone) | To start the **Android Lint** process, the repository that needs to be built must be fetched from the branch. This generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Lint** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To start the **Android Lint** process, the repository that needs to be built must be fetched from the branch. This generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Lint** step. | :::caution Please ensure that you insert the **Android Lint** step before using the **Android Build** step. diff --git a/docs/workflows/android-specific-workflow-steps/post-processor.md b/docs/workflows/android-specific-workflow-steps/post-processor.md index 0b37e218f..8954359db 100644 --- a/docs/workflows/android-specific-workflow-steps/post-processor.md +++ b/docs/workflows/android-specific-workflow-steps/post-processor.md @@ -18,9 +18,9 @@ The workflow steps that need to be executed before running the **Android App Pos | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | -| [Android Build](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | To process Android output, these outputs must be obtained from the build step. | -| [Android Sign](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-sign) | If a signed app is created, this step needs to be run beforehand to process this output. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | +| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | To process Android output, these outputs must be obtained from the build step. | +| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-sign) | If a signed app is created, this step needs to be run beforehand to process this output. | @@ -38,7 +38,7 @@ The outputs that can result from the operation of this component are listed as f | Variable Name | Description | |----------------------------------------|---------------------------------------------------| -| `$AC_ANDROID_POST_PROCESS_OUTPUT_PATH` | Specifies the application post process file path. This file specifies the base name for each app and whether it is signed or not. | +| `AC_ANDROID_POST_PROCESS_OUTPUT_PATH` | Specifies the application post process file path. This file specifies the base name for each app and whether it is signed or not. | :::info The output post-processing JSON file should adhere to the following structure: diff --git a/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md b/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md index 7a8496cf2..73044748f 100644 --- a/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md @@ -38,9 +38,9 @@ For each component, specific input variables are required for its operation on y | Variable Name | Description | Status | | ------------------------ | ---------------------------------------------------------------- | --------- | -| `AC_TEST_RESULT_PATH` | Specifies the directory and its subdirectories where compatible test files will be searched. | Required | -| `AC_COVERAGE_RESULT_PATH`| Specifies the coverage path. | Optional | -| `AC_JACOCO_COVERAGE_TYPE`| Determines the parameter in your JaCoCo report based on which the coverage will be calculated. This setting is necessary when using JaCoCo parseable coverage results and specifying the coverage result path. Types description can be found in this [documentation](/continuous-testing/android-testing/running-android-unit-tests#jacoco-test-coverage) | Required | +| `$AC_TEST_RESULT_PATH` | Specifies the directory and its subdirectories where compatible test files will be searched. | Required | +| `$AC_COVERAGE_RESULT_PATH`| Specifies the coverage path. | Optional | +| `$AC_JACOCO_COVERAGE_TYPE`| Determines the parameter in your JaCoCo report based on which the coverage will be calculated. This setting is necessary when using JaCoCo parseable coverage results and specifying the coverage result path. Types description can be found in this [documentation](/continuous-testing/android-testing/running-android-unit-tests#jacoco-test-coverage) | Required | ### Output Variables diff --git a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md index 90eb5d8e5..ea4558bb3 100644 --- a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md +++ b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md @@ -22,8 +22,8 @@ The workflow steps that need to be executed before running the **Wait for Androi | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Android Build](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | This step is necessary to obtain the Android outputs required for processing. Without adding this step beforehand, the **Wait for Android Emulator** step will still function, but the app will not be installed. | -| [Android Sign](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. Failure to add this step beforehand will result in the **Wait for Android Emulator** step still functioning, but since the app is not signed, there may be installation issues. If your app is already signed, you can skip this step. | +| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | This step is necessary to obtain the Android outputs required for processing. Without adding this step beforehand, the **Wait for Android Emulator** step will still function, but the app will not be installed. | +| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. Failure to add this step beforehand will result in the **Wait for Android Emulator** step still functioning, but since the app is not signed, there may be installation issues. If your app is already signed, you can skip this step. | :::caution If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Wait for Android Emulator** step depends on this step. diff --git a/docs/workflows/common-workflow-steps/active-ssh-private-key.md b/docs/workflows/common-workflow-steps/active-ssh-private-key.md index 6a588246f..527e9cb2e 100644 --- a/docs/workflows/common-workflow-steps/active-ssh-private-key.md +++ b/docs/workflows/common-workflow-steps/active-ssh-private-key.md @@ -14,7 +14,7 @@ This step sets up your SSH key in the build machine if you used one to connect y :::caution -If you connect to your repository via SSH, use this step before the [Git Clone](/workflows/common-workflow-steps/git-clone) step. To securely clone repositories connected via SSH, you must define the SSH key for the relevant build agent. +If you connect to your repository via SSH, use this step before the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. To securely clone repositories connected via SSH, you must define the SSH key for the relevant build agent. @@ -28,11 +28,11 @@ Below are the parameters required for this step, along with detailed explanation | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_REPOSITORY_SSH_KEY` | SSH private key in RSA format. This value defaults to `AC_REPOSITORY_SSH_KEY`. It is automatically defined as the [**Reserved Environment Variables**](/environment-variables/appcircle-specific-environment-variables) when an SSH connection is made. | Optional | +| `$AC_REPOSITORY_SSH_KEY` | SSH private key in RSA format. This value defaults to `$AC_REPOSITORY_SSH_KEY`. It is automatically defined as the [**Reserved Environment Variables**](/environment-variables/appcircle-specific-environment-variables) when an SSH connection is made. | Optional | ### Output Variables | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$SSH_AUTH_SOCK` | This is the path to the SSH Auth Socket. | \ No newline at end of file +| `SSH_AUTH_SOCK` | This is the path to the SSH Auth Socket. | \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/add-badge-app-icon.md b/docs/workflows/common-workflow-steps/add-badge-app-icon.md index 8cc1dfd91..456a26482 100644 --- a/docs/workflows/common-workflow-steps/add-badge-app-icon.md +++ b/docs/workflows/common-workflow-steps/add-badge-app-icon.md @@ -21,7 +21,7 @@ Below is a list of workflow steps that need to be executed before this step, alo | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | :::caution diff --git a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md index 3a3cee471..8f31ab947 100644 --- a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md +++ b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md @@ -28,8 +28,8 @@ Pay attention to the dependent step on whichever platform you are working on. | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Android Build for UI Testing](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The Android Build for UI Testing workflow step is tailored to build your Android test application using Gradle Wrapper (gradlew) for the designated architectures outlined in your project. | -| [Xcodebuild Build for Testing](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/build-and-test/xcodebuild-for-testing) | This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks. | +| [**Android Build for UI Testing**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The Android Build for UI Testing workflow step is tailored to build your Android test application using Gradle Wrapper (gradlew) for the designated architectures outlined in your project. | +| [**Xcodebuild Build for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/build-and-test/xcodebuild-for-testing) | This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks. | #### For iOS @@ -111,10 +111,10 @@ The full details of the tests are accessible in the [AWS Device Farm console](ht | Variable Name | Description | | ---------------------------- | ---------------------------- | -| `$AWS_RUN_ARN` | AWS Device Farm Run ARN. | -| `$AWS_TEST_RESULT` | AWS Device Farm Test result. | -| `$AWS_OUTPUT_DEVICEPOOL_ARN` | The ARN of the Device pool. | -| `$AWS_OUTPUT_APPUPLOAD_ARN` | The ARN of the App Upload. | +| `AWS_RUN_ARN` | AWS Device Farm Run ARN. | +| `AWS_TEST_RESULT` | AWS Device Farm Test result. | +| `AWS_OUTPUT_DEVICEPOOL_ARN` | The ARN of the Device pool. | +| `AWS_OUTPUT_APPUPLOAD_ARN` | The ARN of the App Upload. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/azure-board.md b/docs/workflows/common-workflow-steps/azure-board.md index d210bacd7..4a0f60a0a 100644 --- a/docs/workflows/common-workflow-steps/azure-board.md +++ b/docs/workflows/common-workflow-steps/azure-board.md @@ -65,7 +65,7 @@ We recommend using [Environment Variables](/environment-variables/) groups for s | `$AC_AZUREBOARD_TEMPLATE` | This comment template will be used to post a comment. Variables donated with `$` will be replaced during the build. Please check [this document](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update?view=azure-devops-rest-7.0) to learn more about possible updates. | Required | :::tip -If you add state names for successful and failed steps (`AC_AZUREBOARD_FAIL_STATE` and `AC_AZUREBOARD_SUCCESS_STATE`), the Azure Boards component will automatically change the status of your issue according to the state of your workflow. +If you add state names for successful and failed steps (`$AC_AZUREBOARD_FAIL_STATE` and `$AC_AZUREBOARD_SUCCESS_STATE`), the Azure Boards component will automatically change the status of your issue according to the state of your workflow. ::: ### Changing Template diff --git a/docs/workflows/common-workflow-steps/danger.md b/docs/workflows/common-workflow-steps/danger.md index 05c9b45e6..cb7480b24 100644 --- a/docs/workflows/common-workflow-steps/danger.md +++ b/docs/workflows/common-workflow-steps/danger.md @@ -29,7 +29,7 @@ The workflow steps that need to be executed before running the **Danger** step v | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | :::caution @@ -56,7 +56,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | Variable Name | Description | Status | |-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|----------| | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | -| `$AC_DANGER_PATH` | Specifies path of Dangerfile. This path comes from `AC_REPOSITORY_DIR`. If DangerFile is in main directory of your repository. Do not change. | Required | +| `$AC_DANGER_PATH` | Specifies path of Dangerfile. This path comes from `$AC_REPOSITORY_DIR`. If DangerFile is in main directory of your repository. Do not change. | Required | | `$AC_DANGER_EXTRA_PARAMETERS` | Extra command line parameters. For Example: enter `--verbose` for verbose mode. | Optional | | `$DANGER_GITHUB_API_TOKEN` | Github Access Token for the bot user. | Optional | | `$DANGER_GITHUB_HOST` | The host that GitHub is running on. For example: `git.corp.com` | Optional | diff --git a/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md b/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md index e7c2950f9..c30f74f87 100644 --- a/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md +++ b/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md @@ -67,10 +67,6 @@ Confidential information should be entered as a [secret environment variable](/e | `$AC_DT_UPLOAD_API_KEY` | Specifies the Data Theorem Mobile Secure Upload API Key. You need to obtain your organization's Upload API key from the portal. For more details, refer to [this document](https://docs.securetheorem.com/mobile_security_devops/uploading_mobile_apps.html). | Required | -### Output Variables - -The **Data Theorem Mobile Secure** step does not produce any output variables. The results are shown in the build log. - --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/fastlane.md b/docs/workflows/common-workflow-steps/fastlane.md index 04ad74b46..88dafe789 100644 --- a/docs/workflows/common-workflow-steps/fastlane.md +++ b/docs/workflows/common-workflow-steps/fastlane.md @@ -18,7 +18,7 @@ The workflow steps that need to be executed before running the Fastlane workflow | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the Fastlane process. After the clone, Fastlane will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the Fastlane process. After the clone, Fastlane will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | diff --git a/docs/workflows/common-workflow-steps/firebase-app-distribution.md b/docs/workflows/common-workflow-steps/firebase-app-distribution.md index 38454745e..9eda4b09b 100644 --- a/docs/workflows/common-workflow-steps/firebase-app-distribution.md +++ b/docs/workflows/common-workflow-steps/firebase-app-distribution.md @@ -17,9 +17,9 @@ Please note that you can also distribute your app via Appcircle. Utilizing Appci For more details, please refer to the following links: -- [Appcircle Testing Distribution](/testing-distribution/) -- [Appcircle Enterprise App Store](/enterprise-app-store/) -- [Appcircle Publish](/publish-module/) +- [**Appcircle Testing Distribution**](/testing-distribution/) +- [**Appcircle Enterprise App Store**](/enterprise-app-store/) +- [**Appcircle Publish**](/publish-module/) ::: diff --git a/docs/workflows/common-workflow-steps/git-clone.md b/docs/workflows/common-workflow-steps/git-clone.md index e23da7dbb..da447269c 100644 --- a/docs/workflows/common-workflow-steps/git-clone.md +++ b/docs/workflows/common-workflow-steps/git-clone.md @@ -53,7 +53,7 @@ After connecting the repository, the following [**Reserved Environment Variables | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$AC_REPOSITORY_DIR` | Specifies the root directory of the cloned repository. This path is automatically generated after the repository is cloned. | +| `AC_REPOSITORY_DIR` | Specifies the root directory of the cloned repository. This path is automatically generated after the repository is cloned. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/marathon-cloud.md b/docs/workflows/common-workflow-steps/marathon-cloud.md index 1d8a8bda2..dc2b2ee60 100644 --- a/docs/workflows/common-workflow-steps/marathon-cloud.md +++ b/docs/workflows/common-workflow-steps/marathon-cloud.md @@ -57,8 +57,8 @@ We recommend using [**Environment Variables**](https://docs.appcircle.io/environ |-------------------------------|------------------------------------------------|------------------| | `$AC_MARATHON_API_KEY` | Marathon Cloud API key. To get an API key, please follow the Marathon Cloud [**documentation**](https://docs.marathonlabs.io/?_gl=1*fsz3tj*_ga*MTYyMzE3NDMwOC4xNzA2Njk3MzA5*_ga_7RE7PPY2QW*MTcxMTAwMzEyNC4yNS4xLjE3MTEwMDU5ODYuMjQuMC4w*_gcl_au*MjA1NTI4NzUyNC4xNzA2Njk3MzUw#api-key). | Required | | `$AC_MARATHON_TEST_NAME` | This name will be shown on the Marathon Cloud dashboard test run list. | Required | -| `$AC_MARATHON_APP_PATH` | Specify the path to the application binary. This application is generated by the corresponding testing step (**Android Build for UI Testing** or **Xcodebuild for Testing**). The default value is `AC_APK_PATH ` for Android or `AC_TEST_IPA_PATH` for iOS. | Required | -| `$AC_MARATHON_UITEST_RUNNER_APP_PATH` | Specifies the path to the test application binary. This application is generated by the corresponding testing step (**Android Build for UI Testing** or **Xcodebuild for Testing**). The default value is `AC_TEST_APK_PATH ` for Android or `AC_UITESTS_RUNNER_PATH` for iOS. | Required | +| `$AC_MARATHON_APP_PATH` | Specify the path to the application binary. This application is generated by the corresponding testing step (**Android Build for UI Testing** or **Xcodebuild for Testing**). The default value is `$AC_APK_PATH ` for Android or `$AC_TEST_IPA_PATH` for iOS. | Required | +| `$AC_MARATHON_UITEST_RUNNER_APP_PATH` | Specifies the path to the test application binary. This application is generated by the corresponding testing step (**Android Build for UI Testing** or **Xcodebuild for Testing**). The default value is `$AC_TEST_APK_PATH ` for Android or `$AC_UITESTS_RUNNER_PATH` for iOS. | Required | | `$AC_OUTPUT_DIR` | Specifies the path for Marathon Cloud outputs. This path will be automatically defined. Do not change if it is not necessary. | Required | To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/publish-release-notes.md b/docs/workflows/common-workflow-steps/publish-release-notes.md index ba60dff90..f2e21927e 100644 --- a/docs/workflows/common-workflow-steps/publish-release-notes.md +++ b/docs/workflows/common-workflow-steps/publish-release-notes.md @@ -40,14 +40,12 @@ You can find all the parameters required for this step in the table below, along | Variable Name | Description | Status | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_RELEASE_NOTES_PATH` | Specifies the path of the release notes. You can override the `AC_RELEASE_NOTES_PATH` environment variable or provide its full path, e.g., `./release-notes.txt`. If the path is empty, release notes will be auto-generated. | Optional | +| `$AC_RELEASE_NOTES_PATH` | Specifies the path of the release notes. You can override the `$AC_RELEASE_NOTES_PATH` environment variable or provide its full path, e.g., `./release-notes.txt`. If the path is empty, release notes will be auto-generated. | Optional | | `$AC_RELEASE_NOTES_TEMPLATE` | This variable is an ERB template. You can enrich the contents of your release notes with environment variables or Ruby snippets. | Optional | ### Output Variables -| Variable Name | Description | -| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ` ` | This step creates the `release-notes.txt` file. It does not keep this file in a variable, but you can access this file via [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). | +This step creates the `release-notes.txt` file. It does not keep this file in a variable, but you can access this file via [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). diff --git a/docs/workflows/common-workflow-steps/repeato-test-runner.md b/docs/workflows/common-workflow-steps/repeato-test-runner.md index f9331d2be..5897fbc04 100644 --- a/docs/workflows/common-workflow-steps/repeato-test-runner.md +++ b/docs/workflows/common-workflow-steps/repeato-test-runner.md @@ -58,9 +58,9 @@ The outputs resulting from the operation of this component are as follows: | Variable Name | Description | | -------------------------- | -------------------------------------------------------- | -| `$AC_REPEATO_REPORT` | Report of Repeato batches that have been executed. | -| `$AC_REPEATO_JUNIT_REPORT` | Report of Repeato executed tests in JUnit XML format. | -| `$AC_TEST_RESULT_PATH` | The directory where your JUnit XML report will be saved. | +| `AC_REPEATO_REPORT` | Report of Repeato batches that have been executed. | +| `AC_REPEATO_JUNIT_REPORT` | Report of Repeato executed tests in JUnit XML format. | +| `AC_TEST_RESULT_PATH` | The directory where your JUnit XML report will be saved. | --- diff --git a/docs/workflows/common-workflow-steps/snyk-scan-security.md b/docs/workflows/common-workflow-steps/snyk-scan-security.md index ad6ccceb0..30a7d4722 100644 --- a/docs/workflows/common-workflow-steps/snyk-scan-security.md +++ b/docs/workflows/common-workflow-steps/snyk-scan-security.md @@ -53,8 +53,8 @@ The outputs resulting from the operation of this component are as follows: | Output Variable | Description | |--------------------------------|--------------------------------------------------------------------------------------------------------------------------| -| `$AC_SNYK_REPORT` | The [Snyk report](https://docs.snyk.io/manage-risk/reporting/) file containing the results of executed tests. | -| `$AC_SNYK_MONITOR_EXPLORE_LINK`| The [link to explore and monitor](https://docs.snyk.io/snyk-cli/commands/monitor) the project's security status on Snyk. | +| `AC_SNYK_REPORT` | The [Snyk report](https://docs.snyk.io/manage-risk/reporting/) file containing the results of executed tests. | +| `AC_SNYK_MONITOR_EXPLORE_LINK`| The [link to explore and monitor](https://docs.snyk.io/snyk-cli/commands/monitor) the project's security status on Snyk. | --- diff --git a/docs/workflows/common-workflow-steps/testinium.md b/docs/workflows/common-workflow-steps/testinium.md index 77b2e404c..f6a410818 100644 --- a/docs/workflows/common-workflow-steps/testinium.md +++ b/docs/workflows/common-workflow-steps/testinium.md @@ -81,9 +81,9 @@ Below are the output variables generated by this component: | Variable Name | Description | | -------------------------------------- | ------------------------------------------------------- | -| `$AC_TESTINIUM_RESULT_FAILURE_SUMMARY` | Total number of failures in the test. | -| `$AC_TESTINIUM_RESULT_ERROR_SUMMARY` | Total number of errors in the test. | -| `$AC_TESTINIUM_RESULT_SUCCESS_SUMMARY` | Total number of successes in the test results. | +| `AC_TESTINIUM_RESULT_FAILURE_SUMMARY` | Total number of failures in the test. | +| `AC_TESTINIUM_RESULT_ERROR_SUMMARY` | Total number of errors in the test. | +| `AC_TESTINIUM_RESULT_SUCCESS_SUMMARY` | Total number of successes in the test results. | --- diff --git a/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md b/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md index 732de0d20..16eb71083 100644 --- a/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md +++ b/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md @@ -49,7 +49,7 @@ As the output may vary depending on the task you execute, there is no specific o | Output Variable | Description | |-------------------------|----------------------------------------------------------------| -| `$AC_AWS_UPLOAD_URL` | Specifies that the files and folders are deployed to a newly created directory as `s3://bucket-name/timestamp` to avoid any conflicts and potential overwrites. | +| `AC_AWS_UPLOAD_URL` | Specifies that the files and folders are deployed to a newly created directory as `s3://bucket-name/timestamp` to avoid any conflicts and potential overwrites. | After saving your settings, the build can be run, and the step will be executed accordingly. Details of the upload operation can be viewed in the build logs: diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md index dca5cb4a1..a0875ac86 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md @@ -47,8 +47,8 @@ The outputs resulting from the operation of this component are as follows: | Output Variable | Description | |---------------------------|---------------------------------| -| `$AC_APK_PATH` | Path of the generated APK file. | -| `$AC_AAB_PATH` | Path of the generated AAB file. | +| `AC_APK_PATH` | Path of the generated APK file. | +| `AC_AAB_PATH` | Path of the generated AAB file. | :::info diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md index d8fe99d45..e95444240 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md @@ -42,7 +42,7 @@ You can find all the parameters required for this step in the table below, along | Variable Name | Description | |------------------------|-------------------------------------| -| `$AC_FLUTTER_WEB_PATH` | This path is generated after the completion of the **Flutter Build for Web** step and stores the generated web application. | +| `AC_FLUTTER_WEB_PATH` | This path is generated after the completion of the **Flutter Build for Web** step and stores the generated web application. | ### Deploying Applications to AWS Services diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md index c1787f0ce..6ff1433b9 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md @@ -39,7 +39,7 @@ You can find all the parameters required for this step in the table below, with | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$AC_TEST_RESULT_PATH` | This path is created after the test results are reported. If you are using the [**Export Build Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step, it can be accessed directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). | +| `AC_TEST_RESULT_PATH` | This path is created after the test results are reported. If you are using the [**Export Build Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step, it can be accessed directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md index f27da2c1f..4eac2aaa5 100644 --- a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md +++ b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md @@ -1,6 +1,6 @@ --- title: App Center iOS Distribution -description: Distribute your iOS app to App Center for testing and distribution. `Prerequisite:` Xcodebuild for Devices step. +description: Distribute your iOS app to App Center for testing and distribution. tags: [build, test, distribute, app center, ios, workflow, step] --- @@ -45,12 +45,12 @@ We recommend using [Environment Variables](https://docs.appcircle.io/environment | `$AC_APPCENTER_APPNAME` | The name of the app. The app's name can be identified in its URL, such as `https://appcenter.ms/users/JohnDoe/apps/myapp` for a user-owned app (where **myapp** is the app name) and `https://appcenter.ms/orgs/Appcircle/apps/myapp` for an org-owned app (the owner is **myapp**). | Required | | `$AC_APPCENTER_GROUPS` | The group name parameter is the distribution of `Group Names` you opened in your App Center account. You can type in which group you want to send it to. | Optional | | `$AC_APPCENTER_STORE` | Name of the store (App Store, Google Play, Intune). You can submit directly to this variable by giving one of the store names in your App Center account. | Optional | -| `AC_APPCENTER_RELEASE_NOTES_PATH` | If you use the `Publish Release Notes` component before this step, release-notes.txt will be used as release notes. | Optional | +| `$AC_APPCENTER_RELEASE_NOTES_PATH` | If you use the `Publish Release Notes` component before this step, release-notes.txt will be used as release notes. | Optional | | `$AC_APPCENTER_UPLOAD_DSYM` | The user can decide whether to upload your `dSYM` file. This parameter uploads the `dSYM` file automatically. The default value is **true**. | Optional | | `$AC_APPCENTER_MANDATORY` | This parameter specifies whether the update should be considered mandatory or not. The default value is **false**. | Optional | | `$AC_APPCENTER_NOTIFY` | This parameter sends notifications to testers. The default value is **true**. | Optional | -| `AC_APPCENTER_VERSION` | The latest version will be used if no version is set. | Optional | -| `AC_APPCENTER_EXTRA` | Extra command line arguments for App Center. For example, add `--debug` for verbose logs. | Optional | +| `$AC_APPCENTER_VERSION` | The latest version will be used if no version is set. | Optional | +| `$AC_APPCENTER_EXTRA` | Extra command line arguments for App Center. For example, add `--debug` for verbose logs. | Optional | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index 44ed1289b..f545aca82 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -20,7 +20,7 @@ The workflow steps that need to be executed before running the **Appdome Build-2 | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | -| [Xcodebuild for Devices](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) | The app required for this step is generated by the **Xcodebuild for Devices** (or alternative build steps). | +| [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) | The app required for this step is generated by the **Xcodebuild for Devices** (or alternative build steps). | :::danger If a step other than the **Xcodebuild for Devices** step is used to build or sign the app, then the **Appdome Build-2Secure for iOS** step depends on this step. @@ -62,6 +62,6 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w | Variable Name | Description | Status | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured .ipa file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing` | Required | -| `$AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | TLocal path of the .sh sign script file. Available when `Signing Method` set to `Auto-Dev-Signing` | Required | -| `$AC_APPDOME_CERTIFICATE_PATH` | Local path of the Certified Secure Certificate `.pdf` file | Required | +| `AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured .ipa file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing` | Required | +| `AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | TLocal path of the .sh sign script file. Available when `Signing Method` set to `Auto-Dev-Signing` | Required | +| `AC_APPDOME_CERTIFICATE_PATH` | Local path of the Certified Secure Certificate `.pdf` file | Required | diff --git a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md index 8f249946c..8bd683055 100644 --- a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md +++ b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md @@ -18,7 +18,7 @@ Before running the **Audit Permission Changes** step, you must complete certain | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Audit Permission Changes process. After cloning, the system installs CocoaPods. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Audit Permission Changes process. After cloning, the system installs CocoaPods. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | diff --git a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md index cd3a157fb..a455abf42 100644 --- a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md +++ b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md @@ -39,7 +39,7 @@ Do not specify the **Access Key** directly in a hard coded format in steps. Plea | `$AC_BROWSERSTACK_ACCESS_KEY` | Access key for the **BrowserStack** account. It should come from the **BrowserStack** account. For more information, please follow [this document](https://www.browserstack.com/docs/iaam/security/manage-access-keys). | Required | | `$AC_TEST_IPA_PATH` | Full path of the IPA file. This path will automatically generate in [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) step.| Required | | `$AC_UITESTS_RUNNER_PATH` | Full path of the *-Runner.app. This path will automatically generate in [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) step. | Required | -| `$AC_BROWSERSTACK_PAYLOAD` | `AC_BROWSERSTACK_APP_URL` and `AC_BROWSERSTACK_TEST_URL` will be auto generated. Please check the [documentation](https://www.browserstack.com/docs/app-automate/api-reference/xcuitest/builds#execute-a-build) for more details about the payload. | Optional | +| `$AC_BROWSERSTACK_PAYLOAD` | `$AC_BROWSERSTACK_APP_URL` and `$AC_BROWSERSTACK_TEST_URL` will be auto generated. Please check the [documentation](https://www.browserstack.com/docs/app-automate/api-reference/xcuitest/builds#execute-a-build) for more details about the payload. | Optional | | `$AC_BROWSERSTACK_TIMEOUT` | **BrowserStack** plans a timeout in seconds. If there is any problem in BrowserStack, these variables will break the pipeline after a certain time. The default variable is **600 seconds**. | Required | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/carthage.md b/docs/workflows/ios-specific-workflow-steps/carthage.md index cf4b0b194..802972e83 100644 --- a/docs/workflows/ios-specific-workflow-steps/carthage.md +++ b/docs/workflows/ios-specific-workflow-steps/carthage.md @@ -18,7 +18,7 @@ Appcircle will look for a [`Cartfile`](https://github.com/Carthage/Carthage/blob | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) | This step clones your git repo on the runner where the build process will take place so that the necessary workflow operations can be performed. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) | This step clones your git repo on the runner where the build process will take place so that the necessary workflow operations can be performed. | @@ -32,7 +32,7 @@ You can find all the parameters required for this step in the table below, with |-------------------------------|------------------------------------------------|------------------| | `$AC_CARTHAGE_COMMAND` | Specifies the Carthage command to run. Defaults to `bootstrap`. **Possible values:** `bootstrap`, `update` | Required | | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone).| Optional | -| `$AC_CARTFILE_PATH` | Specifies the path where the Cartfile resides. Defaults to the repository directory. **DO NOT** include Cartfile, this is only the path. **This value will be appended** to `AC_REPOSITORY_DIR`. **Example:** `./` or `./subpath-to-cartfile/` | Optional | +| `$AC_CARTFILE_PATH` | Specifies the path where the Cartfile resides. Defaults to the repository directory. **DO NOT** include Cartfile, this is only the path. **This value will be appended** to `$AC_REPOSITORY_DIR`. **Example:** `./` or `./subpath-to-cartfile/` | Optional | | `$AC_CARTHAGE_FLAGS` | Specifies additional flags after the Carthage command. The default value is empty. **For Xcode 12 and above, make sure to include** `--use-xcframeworks` **here**. To shorten the build time, make sure to specify the platform: `--platform iOS`. Example usage: `--platform iOS --use-xcframeworks` | Optional | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md index 9cbc67f2d..a6025cfd8 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md @@ -18,7 +18,7 @@ Before running the **CocoaPods Deintegrate** step, you must complete certain pre | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods Deintegrate process. After the clone, Fastlane will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created.| +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods Deintegrate process. After the clone, Fastlane will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created.| :::caution diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md index 46f846616..573c2e4ac 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md @@ -16,7 +16,7 @@ The workflow steps that need to be executed before running the **Cocoapods Insta | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | diff --git a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md index f09c2292c..dbb4f78da 100644 --- a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md +++ b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md @@ -41,7 +41,7 @@ The parameters required for the operation of this stepper are given below with e | Variable Name | Description | |-------------------------------|-------------------------------------| -| `$AC_CONVERTED_TEST_RESULT_PATH` | Specifies the path where the converted result is stored. Users can access this path via this variable. Additionally, it will be available for download in the [**Download Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. | +| `AC_CONVERTED_TEST_RESULT_PATH` | Specifies the path where the converted result is stored. Users can access this path via this variable. Additionally, it will be available for download in the [**Download Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. | :::caution To view the converted test reports on the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. diff --git a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md index 7b3f1d570..2afdebb26 100644 --- a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md +++ b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md @@ -49,8 +49,8 @@ The output parameters after this step is executed are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$AC_KEYCHAIN_PATH` | A path is created after the certificate is added to the current runner's keychain. | -| `$AC_KEYCHAIN_PASSWORD` | After this certificate is added to the keychain, the password assigned to the keychain | +| `AC_KEYCHAIN_PATH` | A path is created after the certificate is added to the current runner's keychain. | +| `AC_KEYCHAIN_PASSWORD` | After this certificate is added to the keychain, the password assigned to the keychain | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/slather.md b/docs/workflows/ios-specific-workflow-steps/slather.md index 0d529c3ce..3895f524e 100644 --- a/docs/workflows/ios-specific-workflow-steps/slather.md +++ b/docs/workflows/ios-specific-workflow-steps/slather.md @@ -12,10 +12,10 @@ This step converts Xcode's test results to different formats by using [**Slather ### Prerequisites -| Prerequisite Workflow Step | Description | -|-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-unit-and-ui-tests) | This step executes your unit and UI tests, generating a `.xcresult` file. This file serves as the mandatory test result input for **Slather**. | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your repository. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | +| Prerequisite Workflow Step | Description | +|------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your repository. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | +| [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-unit-and-ui-tests) | This step executes your unit and UI tests, generating a `.xcresult` file. This file serves as the mandatory test result input for **Slather**. | diff --git a/docs/workflows/ios-specific-workflow-steps/swiftlint.md b/docs/workflows/ios-specific-workflow-steps/swiftlint.md index 8f6d5d656..8b919c775 100644 --- a/docs/workflows/ios-specific-workflow-steps/swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/swiftlint.md @@ -15,8 +15,8 @@ Remember, SwiftLint must be used after the following steps in order to work as e | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed, and then SwiftLint will be run. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the input variable for CocoaPods and SwiftLint. | -| [Cocoapods Install](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install)| This step will install the dependencies in the project before SwiftLint can run. | +| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed, and then SwiftLint will be run. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the input variable for CocoaPods and SwiftLint. | +| [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install)| This step will install the dependencies in the project before SwiftLint can run. | @@ -43,13 +43,13 @@ You can also customize your SwiftLint step with the options in the component. Yo | `$AC_LINT_CONFIG` | Specifies the linting configuration file. For example: `/.swiftlint.yml` | Optional | | `$AC_LINT_REPORTER` | You can change the report type with the `Reporter Format` option. This option supports extensions such as **`html`**, **`json`**, **`junit`**, etc. The default is **Xcode**. | Optional | | `$AC_LINT_STRICT` | If there is a failure in the running lint, you can break the pipeline with the **Strict** option. The default value is `NO`. | Optional | -| `AC_LINT_QUIET` | If you want the logs to be simpler, you can make the report file simpler with the **Quiet Mode** feature. | Optional | +| `$AC_LINT_QUIET` | If you want the logs to be simpler, you can make the report file simpler with the **Quiet Mode** feature. | Optional | ### Output Variables | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$AC_LINT_OUTPUT_PATH` | The path of the SwfitLint results output file. After SwiftLint runs, all results will be written in a .txt file. It can be found in the download artifacts. | +| `AC_LINT_OUTPUT_PATH` | The path of the SwfitLint results output file. After SwiftLint runs, all results will be written in a .txt file. It can be found in the download artifacts. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md b/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md index fa89acfdf..190f563c8 100644 --- a/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md @@ -35,8 +35,8 @@ For each component, specific input variables are required for its operation on y | Variable Name | Description | Status | | ------------------------ | ---------------------------------------------------------------- | --------- | -| `AC_TEST_RESULT_PATH` | Define the directory and its subdirectories for searching compatible test files. | Required | -| `AC_COVERAGE_RESULT_PATH`| For native iOS projects, tests automatically set this variable. For other projects, you must specify the coverage path manually. | Optional | +| `$AC_TEST_RESULT_PATH` | Define the directory and its subdirectories for searching compatible test files. | Required | +| `$AC_COVERAGE_RESULT_PATH`| For native iOS projects, tests automatically set this variable. For other projects, you must specify the coverage path manually. | Optional | ### Output Variables diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md index 0c752e127..eb32e7ae8 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md @@ -18,8 +18,8 @@ Before you run the **Tuist Commands** step, you must complete certain prerequisi | Prerequisite Workflow Step | Description | |---------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist Commands process. After cloning, it creates the `AC_REPOSITORY_DIR` variable, and the system is able to run the Tuist Commands. | -| [Tuist Install](/workflows/ios-specific-workflow-steps/tuist-install) | You need to install the Tuist to start the Tuist Commands process. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist Commands process. After cloning, it creates the `AC_REPOSITORY_DIR` variable, and the system is able to run the Tuist Commands. | +| [**Tuist Install**](/workflows/ios-specific-workflow-steps/tuist-install) | You need to install the Tuist to start the Tuist Commands process. | :::caution Tuist Commands diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-install.md b/docs/workflows/ios-specific-workflow-steps/tuist-install.md index cb36d57a9..1444fce24 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-install.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-install.md @@ -24,7 +24,7 @@ Before you run the **Tuist Install** step, you must complete certain prerequisit | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist process. After cloning, the system installs Tuist and creates the `AC_REPOSITORY_DIR` variable. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist process. After cloning, the system installs Tuist and creates the `AC_REPOSITORY_DIR` variable. | :::caution Tuist Usage diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md index 5726dabb9..702bdd146 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md @@ -21,8 +21,8 @@ The workflow steps that need to be executed before running this step, along with | Require Workflow Step | Description | | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repository that needs to be built must be fetched from the Git provider. **Xcodebuild for Devices** should be used after this step. | -| [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) | This step installs all pod dependencies for project. **Xcodebuild for Devices** should be used after this step. If you use SPM (Swift Package Manager), it is not necessary to use. | | [**Xcode Select**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcode-select-version) | In this step, select the Xcode version to build. **Xcodebuild for Devices** should be used after this step. | +| [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) | This step installs all pod dependencies for project. **Xcodebuild for Devices** should be used after this step. If you use SPM (Swift Package Manager), it is not necessary to use. | :::danger This step should always follow steps that may affect Archive and Export, such as Xcode Select and Cocoapods Install. diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md index 818783cc2..342dcfa24 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md @@ -52,7 +52,7 @@ Be aware of which OS version you used; the simulator type should match that OS v | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$AC_SIMULATOR_APP_PATH` | Simulator app path. You can reach the Simulator app from this path, and it will be exported, it can be downloaded from the download artifacts. | +| `AC_SIMULATOR_APP_PATH` | Simulator app path. You can reach the Simulator app from this path, and it will be exported, it can be downloaded from the download artifacts. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md index fdb7c2d7a..0b8a2c9e5 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md @@ -47,12 +47,12 @@ This component outputs some important parameters after running. | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `$AC_TEST_APP_PATH` | This parameter is the path of the application after the build is complete. If you are using a test automation tool, you can use this path as the app path. | -| `$AC_UITESTS_RUNNER_PATH` | This path is the UI Runner Path for running UI tests after the build is complete. This variable is sent to test automation tools to run the tests. | -| `$AC_XCTEST_PATH` | This variable is the path containing the tests. | -| `$AC_UITESTS_RUNNER_IPA_PATH` | This variable is the path that the IPA generated for the test creates for the UI tests to run. This can be sent directly to test automation tools. | -| `$AC_XCTEST_ZIP_PATH` | Path to the IPA version of the Xctests. You can access it directly via this path. | -| `$AC_TEST_IPA_PATH` | This path holds the IPA file created for running tests and sending the IPA file to test automation tools. | +| `AC_TEST_APP_PATH` | This parameter is the path of the application after the build is complete. If you are using a test automation tool, you can use this path as the app path. | +| `AC_UITESTS_RUNNER_PATH` | This path is the UI Runner Path for running UI tests after the build is complete. This variable is sent to test automation tools to run the tests. | +| `AC_XCTEST_PATH` | This variable is the path containing the tests. | +| `AC_UITESTS_RUNNER_IPA_PATH` | This variable is the path that the IPA generated for the test creates for the UI tests to run. This can be sent directly to test automation tools. | +| `AC_XCTEST_ZIP_PATH` | Path to the IPA version of the Xctests. You can access it directly via this path. | +| `AC_TEST_IPA_PATH` | This path holds the IPA file created for running tests and sending the IPA file to test automation tools. | To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md index ed5c8660e..eea1b0ca4 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md @@ -67,4 +67,4 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w ### Output Variables | Variable Name | Description | |-------------------------------|----------------------------------------------------------------------------------------------------------| -| `$AC_TEST_RESULT_PATH` | The output path for the `.xcresult` file. This environment variable can be utilized in subsequent steps. | \ No newline at end of file +| `AC_TEST_RESULT_PATH` | The output path for the `.xcresult` file. This environment variable can be utilized in subsequent steps. | \ No newline at end of file diff --git a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md index ddd307305..e06bde4f6 100644 --- a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md +++ b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md @@ -18,7 +18,7 @@ Before running the **App Center CodePush** step, you must complete certain prere | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [Git Clone](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the CodePush process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the CodePush process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | From 6adb8aaf7faa67ef25a8b55c448c55d0ff5d2521 Mon Sep 17 00:00:00 2001 From: boztopuz Date: Wed, 13 Nov 2024 16:45:48 +0300 Subject: [PATCH 02/10] Revision applied for wf step documentations --- .../android-build-for-ui-testing.md | 8 ++++++- .../android-build.md | 10 +++++++++ .../android-dependency-report.md | 2 ++ .../android-sign.md | 10 +++++++++ .../android-unit-tests.md | 2 ++ .../app-center-android-distribution.md | 4 ++++ .../app-post-processor.md | 6 +++++ .../appdome-build-to-secure-for-android.md | 4 ++++ .../appsweep-mobile-security-testing.md | 2 ++ .../bundle-universal-apk.md | 4 ++++ .../gradle-runner.md | 4 ++++ .../increment-build-and-version-number.md | 1 + .../android-specific-workflow-steps/lint.md | 4 ++++ .../post-processor.md | 3 +++ .../wait-for-android-emulator.md | 6 +++++ .../active-ssh-private-key.md | 11 +++++++++- .../add-badge-app-icon.md | 4 +++- .../common-workflow-steps/appium-server.md | 8 ++++++- .../authenticate-with-netrc.md | 6 +++++ .../aws-device-farm-and-deploy.md | 4 ++++ .../common-workflow-steps/azure-board.md | 8 +++++++ .../build-cache/cache-pull.md | 6 +++++ .../build-cache/cache-push.md | 14 ++++++++++++ ...ow-to-share-file-between-build-profiles.md | 10 +++++++++ .../how-to-share-file-between-pipelines.md | 22 ++++++++++++++----- .../build-cache/index.md | 17 +++++++++++++- .../common-workflow-steps/custom-script.md | 18 ++++++++++----- .../workflows/common-workflow-steps/danger.md | 1 + .../export-build-artifacts.md | 8 +++++++ .../common-workflow-steps/fastlane.md | 7 +++++- .../common-workflow-steps/file-size-check.md | 6 +++++ .../firebase-app-distribution.md | 4 ---- .../fod-mobile-assesment.md | 2 ++ .../common-workflow-steps/ftp-upload.md | 2 +- .../common-workflow-steps/git-clone.md | 8 +++++++ .../maestro-cloud-upload.md | 4 ---- .../common-workflow-steps/marathon-cloud.md | 4 ++++ .../common-workflow-steps/sonarqube.md | 10 +++++++++ .../common-workflow-steps/testinium.md | 2 +- .../firebase-deployment.md | 1 + .../flutter-analyze.md | 3 +++ .../flutter-build-for-android.md | 2 ++ .../flutter-build-for-ios.md | 10 ++++++--- .../flutter-build-for-web.md | 4 +++- .../flutter-install.md | 12 ++++++++++ .../flutter-test.md | 7 ++++++ .../appcenter-ios-distribution.md | 6 +++++ .../appdome-build-to-secure-for-ios.md | 11 ++++++++++ .../audit-permission-change.md | 1 + .../azure-bot-for-swiftlint.md | 10 +++++++++ .../browserstack-app-automation.md | 8 +++++++ .../ios-specific-workflow-steps/carthage.md | 2 ++ .../cocoapods-deintegrate.md | 1 + .../cocoapods-install.md | 6 +++++ .../convert-xcresult-to-xml-html.md | 11 ++++++++++ .../firebase-upload-dsym.md | 20 +++++++++++------ .../install-certificates-provisions.md | 8 +++++++ .../ios-increment-build-and-version-number.md | 1 + .../ios-specific-workflow-steps/slather.md | 5 +++++ .../ios-specific-workflow-steps/swiftlint.md | 9 ++++++++ .../test-reports-for-ios.md | 1 + .../tuist-commands.md | 1 + .../tuist-install.md | 1 + .../xcode-select.md | 8 +++++-- .../xcodebuild-for-devices.md | 14 ++++++++++++ .../xcodebuild-for-ios-simulator.md | 6 +++++ .../xcodebuild-for-testing.md | 4 ++++ .../xcodebuild-for-unit-and-ui-test.md | 3 +++ .../app-center-code-push.md | 5 +---- .../node-install.md | 9 ++++++++ .../npm-yarn-commands.md | 2 ++ .../react-native-ui-test.md | 2 ++ .../react-native-unit-test.md | 2 ++ .../test-reports-react-native.md | 2 ++ 74 files changed, 411 insertions(+), 43 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md index cedfcd9c3..eb742cb32 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md +++ b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md @@ -19,6 +19,7 @@ The workflow steps that need to be executed before running the **Android Build f | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Android Build for UI Testing** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Build for UI Testing** step. | :::caution + If you're updating the version via Appcircle, ensure that the following step comes before the **Android Build for UI Testing** step: - [**Android Increment Build and Version Number**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/increment-build-and-version-number) @@ -26,6 +27,7 @@ If you're updating the version via Appcircle, ensure that the following step com ::: :::caution + If you're working with a **React Native Android** project, ensure that the following steps come before the **Android Build for UI Testing** step: - [**Install Node**](https://docs.appcircle.io/workflows/react-native-specific-workflow-steps/#install-node) @@ -36,7 +38,9 @@ If you're working with a **React Native Android** project, ensure that the follo :::note + The **[Firebase Test Lab for Android](https://docs.appcircle.io/continuous-testing/firebase-test-lab-for-android/)** step has been added as an example. You can use the APK you produce for UI testing in any component you choose. + ::: ### Input Variables @@ -53,13 +57,15 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The outputs resulting from the operation of this component are as follows: | Variable Name | Description | | ------------------- | -------------------------------------------------------------------------------------------------------------------- | | `AC_APK_PATH` | Path for the generated **APK** file. This path will be created after the **Android Build for UI Testing** step runs. | | `AC_TEST_APK_PATH` | Path for the generated `*androidTest.apk` file. This output can be utilized wherever necessary for UI testing. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-build-ui-test-component.git diff --git a/docs/workflows/android-specific-workflow-steps/android-build.md b/docs/workflows/android-specific-workflow-steps/android-build.md index 7fe18e114..da04dc3f3 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build.md +++ b/docs/workflows/android-specific-workflow-steps/android-build.md @@ -36,6 +36,7 @@ For each component, specific input variables are required for its operation on y | `$AC_GRADLE_BUILD_EXTRA_ARGS` | Extra arguments were passed to build task. For more information, please refer to [this Gradle document](https://docs.gradle.org/current/userguide/writing_build_scripts.html#sec:extra_properties). | Optional | :::info + If you have filled in the necessary variables in the **Configuration** section, you will not need to redefine these variables again in the Workflow. For more information about configurations, refer to the [Build Profile Configuration Overview](/build/build-process-management/build-profile-configuration) document. The information you fill in the configuration will be used as input in the Android Build step. Please replace the example information with your own details: @@ -43,10 +44,13 @@ If you have filled in the necessary variables in the **Configuration** section, 1. The input corresponding to the 1st field: `$AC_MODULE` 2. The input corresponding to the 2nd field: `$AC_VARIANTS` 3. The input corresponding to the 3rd field: `$AC_OUTPUT_TYPE` + ::: :::tip + If you are using Gradle 4.3 and above in your project, you can just use the `--scan` flag in the build step to enable build scans. For existing projects, you may need to add the Gradle Scan (Gradle Enterprise) plugin. For more information, please refer to https://scans.gradle.com/ + ::: ### Output Variables @@ -63,15 +67,21 @@ The resulting files will be either APK or AAB, depending on whether you choose t If your project has the [signing configuration](https://developer.android.com/studio/build/gradle-tips#sign-your-app) in Gradle, this step will generate a signed artifact. :::caution + If you do not disable the **Android Sign** step and your project has no signing configuration defined in Gradle, your artifact will remain unsigned. So, in order to sign your app using the keystore selected in the build configuration, you should enable the **Android Sign** step after **Android Build**. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-build-component.git +--- + ## FAQ ### How can I solve the `Out of memory error: Java heap memory` or set the heap memory during the build? diff --git a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md index e2aea4360..f2b70d39f 100644 --- a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md +++ b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md @@ -44,9 +44,11 @@ The outputs that can result from the operation of this component are listed as f | `AC_ANDROID_DEPENDENCY_REPORT_PATH` | Specifies the path where the Android dependency report file is stored. | :::danger + If you wish to review or download the Android Dependencies Report, you can find them directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts). To do this, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step follows the **Android Dependency Report** workflow step. + ::: To access the source code of this component, please use the following link: diff --git a/docs/workflows/android-specific-workflow-steps/android-sign.md b/docs/workflows/android-specific-workflow-steps/android-sign.md index 7e18cb2ee..c30360fa8 100644 --- a/docs/workflows/android-specific-workflow-steps/android-sign.md +++ b/docs/workflows/android-specific-workflow-steps/android-sign.md @@ -11,7 +11,9 @@ import Screenshot from '@site/src/components/Screenshot'; **Android Sign** step signs your *APK* or *AAB* with the given Android *keystore* and exports a binary file compatible with Android devices. :::info + This step follows the [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) step to sign the unsigned build output if the project doesn't include a *keystore*. If your project includes a *keystore*, the build application step will generate a signed artifact. If you do not disable this step, your artifact will be unsigned and then re-signed using the *keystore* selected in the **Configuration** or in this step. + ::: ### Prerequisites @@ -23,13 +25,17 @@ The workflow steps that need to be executed before running the **Android Build** | [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | :::caution + If a step other than the **Android Build** step is used to build an app, then the **Android Sign** step depends on this step. + ::: :::danger + To share the signed apps created as an output of this step or to view them on the **Download Artifacts** page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/#export-build-artifacts) step is included in your workflow after this step. + ::: ### Input Variables @@ -58,9 +64,13 @@ The outputs that can result from the operation of this component are listed as f | `AC_SIGNED_AAB_PATH` | Path for the signed App Bundle file output. If an *AAB* file is provided as input, the signed app will also be in *AAB* format. | :::tip + If both input value types (*AAB* and *APK*) are provided, the same type of signed app will be generated for both. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-sign-component.git diff --git a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md index bacb05d74..4e4d1d35e 100644 --- a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md +++ b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md @@ -49,6 +49,8 @@ The outputs that can result from the operation of this component are listed as f | ---------------------- | -------------------------------------------------------------- | | `AC_TEST_RESULT_PATH` | Specifies the directory where your JUnit XML report is stored. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-unit-test-component.git diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index ddd9fb224..cc50e1e06 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -33,7 +33,9 @@ The workflow steps that need to be executed before running the **App Center Andr | [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::danger + If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **App Center Android Distribute** step depends on this step. + ::: @@ -45,9 +47,11 @@ For each component, specific input variables are required for its operation on y :::danger + **Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** We recommend using [Environment Variables](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. + ::: | Variable Name | Description | Status | diff --git a/docs/workflows/android-specific-workflow-steps/app-post-processor.md b/docs/workflows/android-specific-workflow-steps/app-post-processor.md index 06b3af247..601a7d486 100644 --- a/docs/workflows/android-specific-workflow-steps/app-post-processor.md +++ b/docs/workflows/android-specific-workflow-steps/app-post-processor.md @@ -25,7 +25,9 @@ The workflow steps that need to be executed before running the **Android App Pos :::caution + If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Android App Post-Processor** step depends on this step. + ::: ### Input Variables @@ -41,6 +43,7 @@ The outputs that can result from the operation of this component are listed as f | `$AC_ANDROID_POST_PROCESS_OUTPUT_PATH` | Specifies the application post process file path. This file specifies the base name for each app and whether it is signed or not. | :::info + The output post-processing JSON file should adhere to the following structure: ```jsx title="ac_post_process_output.json" [ @@ -51,10 +54,13 @@ The output post-processing JSON file should adhere to the following structure: {...} ] ``` + ::: :::caution + To share the signed apps created as a result of this step or to view them on the **Download Artifacts** page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. + ::: --- diff --git a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md index 3c2068190..11afce646 100644 --- a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md @@ -24,7 +24,9 @@ The workflow steps that need to be executed before running the **Appdome Build-2 | [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::danger + If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Appdome Build-2Secure for Android** step depends on this step. + ::: @@ -36,7 +38,9 @@ For each component, specific input variables are required for its operation on y :::caution + Confidential information should be entered as a [secret environment variable](https://docs.appcircle.io/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](https://docs.appcircle.io/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). + ::: | Variable Name | Description | Status | diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index f295831a2..a14ab5810 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -29,9 +29,11 @@ For each component, specific input variables are required for its operation on y :::danger + **Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** We recommend using [Environment Variables](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. + ::: | Variable Name | Description | Status | diff --git a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md index c6b147a33..45f27ec89 100644 --- a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md +++ b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md @@ -22,7 +22,9 @@ The workflow steps that need to be executed before running the **Bundle Universa | [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::caution + If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Bundle Universal Apk** step depends on this step. + ::: @@ -50,6 +52,8 @@ The outputs that can result from the operation of this component are listed as f | --------------------- | -------------------------------- | | `AC_SIGNED_APK_PATH` | Path of the signed **APK** file. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-bundletool-component.git diff --git a/docs/workflows/android-specific-workflow-steps/gradle-runner.md b/docs/workflows/android-specific-workflow-steps/gradle-runner.md index db68aca3a..b964f7327 100644 --- a/docs/workflows/android-specific-workflow-steps/gradle-runner.md +++ b/docs/workflows/android-specific-workflow-steps/gradle-runner.md @@ -41,9 +41,13 @@ For each component, specific input variables are required for its operation on y As the output may vary depending on the task you execute, there is no specific output defined by default. :::caution + If there is an output generated, ensure to use the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step afterward to ensure it is included in the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts) page. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-gradle-task-component.git diff --git a/docs/workflows/android-specific-workflow-steps/increment-build-and-version-number.md b/docs/workflows/android-specific-workflow-steps/increment-build-and-version-number.md index c041ec412..ae79534e4 100644 --- a/docs/workflows/android-specific-workflow-steps/increment-build-and-version-number.md +++ b/docs/workflows/android-specific-workflow-steps/increment-build-and-version-number.md @@ -14,6 +14,7 @@ The **Android Increment Build and Version Number** step is managed with **Androi - [**Understanding Android Versioning**](/versioning/android-version) +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/android-specific-workflow-steps/lint.md b/docs/workflows/android-specific-workflow-steps/lint.md index ee7003b50..f5e18bb43 100644 --- a/docs/workflows/android-specific-workflow-steps/lint.md +++ b/docs/workflows/android-specific-workflow-steps/lint.md @@ -21,7 +21,9 @@ The workflow steps that need to be executed before running the **Android Lint** | [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To start the **Android Lint** process, the repository that needs to be built must be fetched from the branch. This generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Lint** step. | :::caution + Please ensure that you insert the **Android Lint** step before using the **Android Build** step. + ::: @@ -60,7 +62,9 @@ The outputs that can result from the operation of this component are listed as f | `-` | Lint does not assign the XML/HTML file output to a variable. However, the resulting file from **Lint** appears in the output (`$AC_OUTPUT_DIR`) and report directory (`/$AC_MODULE/build/reports`). | :::caution + To view the Lint report on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps#export-build-artifacts) step is included in your **Workflow** after this step. + ::: --- diff --git a/docs/workflows/android-specific-workflow-steps/post-processor.md b/docs/workflows/android-specific-workflow-steps/post-processor.md index 8954359db..cd70f1338 100644 --- a/docs/workflows/android-specific-workflow-steps/post-processor.md +++ b/docs/workflows/android-specific-workflow-steps/post-processor.md @@ -54,10 +54,13 @@ The output post-processing JSON file should adhere to the following structure: ::: :::caution + To share the signed apps created as a result of this step or to view them on the **Download Artifacts** page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step is included in your Workflow after this step. + ::: --- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-build-component.git \ No newline at end of file diff --git a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md index ea4558bb3..2a3ab9c31 100644 --- a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md +++ b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md @@ -13,7 +13,9 @@ The **Wait for Android Emulator** step waits for the Android Emulator to boot. Y For additional details, please refer to the [**Emulator**](https://docs.appcircle.io/infrastructure/android-build-infrastructure/#emulator) documentation. :::danger + Ensure that you select the **Intel Pool** in the Configuration tab, as the **Wait for Android Emulator** step will not function in the **M1 Pool**. Please refer to [this documentation](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/#project-details-configuration) for selecting a pool in Configuration. + ::: ### Prerequisites @@ -26,7 +28,9 @@ The workflow steps that need to be executed before running the **Wait for Androi | [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. Failure to add this step beforehand will result in the **Wait for Android Emulator** step still functioning, but since the app is not signed, there may be installation issues. If your app is already signed, you can skip this step. | :::caution + If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Wait for Android Emulator** step depends on this step. + ::: @@ -44,6 +48,8 @@ For each component, specific input variables are required for its operation on y | `$AC_TEST_ADB_ARGUMENTS` | ADB arguments for the device. For additional details about ADB arguments, please refer to the [Android Debug Bridge](https://developer.android.com/tools/adb) documentation. The default value is: `-no-window -no-audio -no-boot-anim -netdelay none -no-snapshot -wipe-data -gpu auto`. You may add new arguments, but don't change the default ones, such as `no-window`. | Required | | `$AC_SIGNED_APK_PATH` | The optional full path of the signed APK file to install after the emulator boots. If this step runs after the **Android Sign** step, the variable will be automatically populated. If the signing takes place in the build step and you want to directly enter the APK you received from the **Android Build** step here, you can change the variable to `$AC_APK_PATH`. | Optional | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-wait-emulator.git diff --git a/docs/workflows/common-workflow-steps/active-ssh-private-key.md b/docs/workflows/common-workflow-steps/active-ssh-private-key.md index 527e9cb2e..2b5862172 100644 --- a/docs/workflows/common-workflow-steps/active-ssh-private-key.md +++ b/docs/workflows/common-workflow-steps/active-ssh-private-key.md @@ -33,6 +33,15 @@ Below are the parameters required for this step, along with detailed explanation ### Output Variables +The outputs resulting from the operation of this component are as follows: + + | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `SSH_AUTH_SOCK` | This is the path to the SSH Auth Socket. | \ No newline at end of file +| `SSH_AUTH_SOCK` | This is the path to the SSH Auth Socket. | + +--- + +To access the source code of this component, please use the following link: + +https://github.com/appcircleio/appcircle-activate-ssh-key-component \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/add-badge-app-icon.md b/docs/workflows/common-workflow-steps/add-badge-app-icon.md index 456a26482..7938e70ad 100644 --- a/docs/workflows/common-workflow-steps/add-badge-app-icon.md +++ b/docs/workflows/common-workflow-steps/add-badge-app-icon.md @@ -61,6 +61,8 @@ To use this component, you must provide the icon path from your project file. He ::: -For the source code of this component, visit: +--- + +To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-badge-component diff --git a/docs/workflows/common-workflow-steps/appium-server.md b/docs/workflows/common-workflow-steps/appium-server.md index bcf2b5eef..a8f67f7e1 100644 --- a/docs/workflows/common-workflow-steps/appium-server.md +++ b/docs/workflows/common-workflow-steps/appium-server.md @@ -29,4 +29,10 @@ Below is a list of input variables that can be used with this component, with a | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_APPIUM_VERSION` | Specifies the version of Appium Server to install, such as `v1.22.3`. If you do not specify a version, the system installs the latest version. | Optional | \ No newline at end of file +| `$AC_APPIUM_VERSION` | Specifies the version of Appium Server to install, such as `v1.22.3`. If you do not specify a version, the system installs the latest version. | Optional | + +--- + +To access the source code of this component, please use the following link: + +https://github.com/appcircleio/appcircle-appium-component \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/authenticate-with-netrc.md b/docs/workflows/common-workflow-steps/authenticate-with-netrc.md index af32bc388..8aa11e3b1 100644 --- a/docs/workflows/common-workflow-steps/authenticate-with-netrc.md +++ b/docs/workflows/common-workflow-steps/authenticate-with-netrc.md @@ -15,7 +15,9 @@ The `.netrc` file contains login and initialization information used by the auto There is no mandatory step before the **Authenticate with Netrc** step. :::danger + Please note that you should use this step before your **Git Clone** step. If you want to connect to a repository that requires access permission or pull a private dependency, please pay attention to the step order. + ::: @@ -27,7 +29,9 @@ You can find all the parameters required for this step in the table below, with :::danger + When using the **Authenticate with Netrc** component, you need to specify a token or password in the `$AC_NETRC_PASS` parameter within the component. For security reasons, we recommend using [**Enviroment Variables**](https://docs.appcircle.io/environment-variables/) in steps where you need to specify the token and password. + ::: | Variable Name | Description | Status | @@ -36,6 +40,8 @@ When using the **Authenticate with Netrc** component, you need to specify a toke | `$AC_NETRC_USER` | Specifies the username of the host. | Required | | `$AC_NETRC_PASS` | The password or the `authentication-token`/`access-token` in the respective field, will be used by the host to authenticate you. | Required | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-netrc-component diff --git a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md index 8f31ab947..e36d82883 100644 --- a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md +++ b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md @@ -109,6 +109,8 @@ The full details of the tests are accessible in the [AWS Device Farm console](ht ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | | ---------------------------- | ---------------------------- | | `AWS_RUN_ARN` | AWS Device Farm Run ARN. | @@ -116,6 +118,8 @@ The full details of the tests are accessible in the [AWS Device Farm console](ht | `AWS_OUTPUT_DEVICEPOOL_ARN` | The ARN of the Device pool. | | `AWS_OUTPUT_APPUPLOAD_ARN` | The ARN of the App Upload. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-aws-device-farm-deploy-and-run diff --git a/docs/workflows/common-workflow-steps/azure-board.md b/docs/workflows/common-workflow-steps/azure-board.md index 4a0f60a0a..e2d4d0dad 100644 --- a/docs/workflows/common-workflow-steps/azure-board.md +++ b/docs/workflows/common-workflow-steps/azure-board.md @@ -19,7 +19,9 @@ You can use the [Azure Boards Component](https://github.com/appcircleio/appcircl There is no mandatory sequence for the use of this component. It depends on your business decision which step to use before or after in your workflow. :::caution + Please note that once the Azure Boards component has run successfully, the status of the relevant article in your Azure Board account will be changed. If the build fails in Appcircle, an incorrect status may appear in your Azure Board account. Make sure you use it in the correct order in Workflow. + ::: ### Configuration of Component @@ -46,9 +48,11 @@ There are some necessary parameters for this stepper to work properly. These par :::danger + **Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. + ::: | Variable Name | Description | Status | @@ -65,7 +69,9 @@ We recommend using [Environment Variables](/environment-variables/) groups for s | `$AC_AZUREBOARD_TEMPLATE` | This comment template will be used to post a comment. Variables donated with `$` will be replaced during the build. Please check [this document](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update?view=azure-devops-rest-7.0) to learn more about possible updates. | Required | :::tip + If you add state names for successful and failed steps (`$AC_AZUREBOARD_FAIL_STATE` and `$AC_AZUREBOARD_SUCCESS_STATE`), the Azure Boards component will automatically change the status of your issue according to the state of your workflow. + ::: ### Changing Template @@ -74,6 +80,8 @@ Appcircle provides a default template that adds the commit ID, branch name, and Please check the [Azure Boards Component](https://github.com/appcircleio/appcircle-azure-boards-component/) documentation for more information. +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-azure-boards-component/ diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md index 481e42626..233e825fe 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md @@ -15,6 +15,7 @@ import Screenshot from '@site/src/components/Screenshot'; ::: :::info + If you need to use the cached folder in a different branch or a separate project, you have the capability to modify the values of `$AC_GIT_BRANCH` or `$AC_BUILD_PROFILE_ID`. For further information, please check out the following documentation: - [How to Share Files Between Pipelines](/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines) - [How to Share Files Between Build Profiles](/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles) @@ -22,20 +23,25 @@ If you need to use the cached folder in a different branch or a separate project These variables can be adjusted within the [cache label](#input-variables) field, as indicated by the red highlight in the accompanying image. Simply replace them with the branch or project ID that corresponds to your intended usage. + ::: ### Prerequisites :::caution + This component does not require any prerequisite steps for operation. The only thing necessary for the component to work as expected is to utilize the cached files before the step in which they will be used. Additionally, an important prerequisite for this step to function properly is that the files to be used must have been cached in previous builds. For example, in the screenshot, to use cached files for Cocoapods, the **Cache Pull** step should be used before the [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/cocoapods-install) step. + ::: :::danger + If there are no previously cached files and you attempt to use this step, the **Cache Pull** step will result in a **`not found error`** because it cannot locate the specified files at the remote location. + ::: ### Input Variables diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-push.md b/docs/workflows/common-workflow-steps/build-cache/cache-push.md index b9de53c72..fe666159f 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-push.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-push.md @@ -21,27 +21,37 @@ When you drag and drop the **Cache Push** component into your [workflow](/workfl If you need more paths to cache or need to change paths according to your project, you can customize [included](#input-variables) and [excluded](#input-variables) paths as you wish. All path updates will be reflected in the archived cache file on your next build. :::danger + You cannot delete a specific cache file from the UI, but if you have a problem with a cache file and need a fresh one, you can change your [cache label](#input-variables) to a new one to go on with a clean cache. + ::: :::info + The system automatically cleans unreachable and obsolete cache files periodically. For this reason, **it's not guaranteed to reach a previously used cache file by using the previous cache label in build**. Also, it’s a good idea to build your workflow in such a way that your **build won’t fail if the cache can’t be accessed**. + ::: ### Prerequisites +Before running the **Cache Push** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) | If the folders to be cached are in the repo directory, the **Git Clone** step must be used before. This step will generate the [`AC_REPOSITORY_DIR`](#input-variables) path. | :::danger + Keep in mind that included paths and the **Cache Push** step's workflow order are closely related to each other. For example, if you include a path from a repository and you place the **Cache Push** step before the **Git Clone** step, **Cache Push** won't find that path since it's not Git cloned yet. Although that's not a fatal error for **Cache Push**, it will inform you about unreachable paths on build logs. You can review and resolve those kinds of issues from build logs. + ::: :::caution + The other important prerequisite for this component to work is that it must be used after the step in which the generated artifact of the step is to be cached. For example, in the screen shot, to cache dependencies, the **Cache Push** step is used after the [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) step. + ::: @@ -59,7 +69,9 @@ The parameters required for the operation of this step are given in the list bel | `$AC_REPOSITORY_DIR` | Specifies the cloned repository path. This path will be generated after running the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) step. | Optional | :::tip + **Cache Push** uses a pattern in order to select files and folders. Although the pattern is not a RegExp, it's closer to a shell glob. For example, `~/Library/Caches/CocoaPods` and `Pods` will select the `CocoaPods` folder from home and the repository direction as a whole. Or for an Android project, you can cache the `.gradle ` folder with `~/.gradle` include path and exclude all `.lock` files from there with `~/.gradle/**/*.lock` exclude path. Patterns that can be used in both included and excluded paths are explained in detail [here](https://github.com/appcircleio/appcircle-cache-push-component#included--excluded-paths). + ::: ### Output Variables @@ -67,7 +79,9 @@ The parameters required for the operation of this step are given in the list bel You cannot reach the cache archive file directly by yourself. But you can see cache file updates and track changes to cache at the end of the build pipeline from '[Download Artifacts](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) > `ac_cache.zip`'. Also, build logs have some useful information about the cache mechanism and how included and excluded paths are processed. You can see the produced cache file size from the build logs. (The size of the cache file affects upload and download durations.) :::caution + To view the generated artifacts on the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step is included in the [workflow](/workflows) after this step. + ::: --- diff --git a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md index cc94aef69..5951a88a1 100644 --- a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md +++ b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md @@ -12,21 +12,29 @@ import Screenshot from '@site/src/components/Screenshot'; With the build cache structure provided by Appcircle, cache files can be shared between different [**Build Profiles**](/build/manage-the-connections/adding-a-build-profile/). This sharing of files enables the faster generation of packages in different Build Profiles, reducing build time. Below is a simple, step-by-step example of how you can achieve this. :::info + This simple example will use our [**CocoaPods**](https://cocoapods.org/) files in different build profiles. If you intend to use a cache other than dependencies, please refer to the documentation for the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) component. + ::: :::caution + To share cache between Build Profiles, the [**Cache Pull**](/workflows/common-workflow-steps/build-cache/cache-pull) component must be added to the related pipeline. + ::: :::caution + As an example, **master** and **development** branches were used, but you can apply the same operations to different branches. + ::: :::danger + Please note that the organizational structure of Appcircle is designed in such a way as to prevent any **security vulnerabilities**. Consequently, exchanging files between organizations or sub-organizations **is not permitted**. You can find detailed information about the Appcircle organizational structure in the documentation [**here**](https://docs.appcircle.io/account/my-organization). + ::: 1. Firstly, the caching of CocoaPods files is initiated in the **`Appcircle Team`** build profile. These files will subsequently be utilized in the **`Appcircle Team 2`** build profile. To accomplish this, the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) step should be incorporated into the workflow after the **CocoaPods Install** step in the initial build profile. @@ -50,5 +58,7 @@ You can find detailed information about the Appcircle organizational structure i :::danger + When sharing cache files between **Build Profiles**, please make sure that you spell your build profile ID and branch names correctly and use the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) and [**Cache Pull**](/workflows/common-workflow-steps/build-cache/cache-pull) steps correctly in each profile.  + ::: \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md index b40dd3e87..4afb403f2 100644 --- a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md +++ b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md @@ -11,21 +11,29 @@ import Screenshot from '@site/src/components/Screenshot'; With the build cache structure provided by Appcircle, you can share cache files between pipelines in different branches. This sharing enables faster package generation across various branches, reducing overall build time. Below is a simple, step-by-step example of how you can achieve this. :::info + This simple example will use our [**CocoaPods**](https://cocoapods.org/) files in a different branch. If you want to use a cache other than dependencies, please refer to the documentation for the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) component. + ::: :::info + As an example, **master** and **development** branches were used, but you can apply the same operations to different branches. + ::: :::danger + Please note that the organizational structure of Appcircle is designed in such a way as to prevent any **security vulnerabilities**. Consequently, exchanging files between organizations or sub-organizations **is not permitted**. You can find detailed information about the Appcircle organizational structure in the documentation [**here**](https://docs.appcircle.io/account/my-organization). + ::: :::caution + In order to share cache between pipelines, the [**Cache Pull**](/workflows/common-workflow-steps/build-cache/cache-pull) component must be added to the related pipeline. + ::: 1. To start, cache the CocoaPods files in the **development** branch, which will later be utilized in the **master** branch. For this purpose, add the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) step to the workflow after the [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/cocoapods-install) step. @@ -44,16 +52,20 @@ In order to share cache between pipelines, the [**Cache Pull**](/workflows/commo - :::caution - If you use more than one cache for the same branch, you can edit the [cache label](/workflows/common-workflow-steps/build-cache/cache-push#input-variables) accordingly in both [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) and [**Cache Pull**](/workflows/common-workflow-steps/build-cache/cache-pull) steps. For example: - - `$AC_BUILD_PROFILE_ID/development/cache-1` - - `$AC_BUILD_PROFILE_ID/development/cache-cocoapods` - ::: +:::caution + +If you use more than one cache for the same branch, you can edit the [cache label](/workflows/common-workflow-steps/build-cache/cache-push#input-variables) accordingly in both [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) and [**Cache Pull**](/workflows/common-workflow-steps/build-cache/cache-pull) steps. For example: +- `$AC_BUILD_PROFILE_ID/development/cache-1` +- `$AC_BUILD_PROFILE_ID/development/cache-cocoapods` + +::: 5. After this parameter change, the CocoaPods dependencies that were cached in the **development** branch pipeline will be automatically pulled to the **master** branch and used directly in the **master** branch pipeline. :::danger + When sharing cache files between pipelines, please make sure that you spell your branch names correctly and use the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) and [**Cache Pull**](/workflows/common-workflow-steps/build-cache/cache-pull) steps correctly.  + ::: \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/build-cache/index.md b/docs/workflows/common-workflow-steps/build-cache/index.md index 219e49d02..81385cc10 100644 --- a/docs/workflows/common-workflow-steps/build-cache/index.md +++ b/docs/workflows/common-workflow-steps/build-cache/index.md @@ -10,16 +10,31 @@ import Screenshot from '@site/src/components/Screenshot'; Learn to streamline your workflows by pushing data to cache with our easy-to-follow cache-push tutorial. Ideal for improving build performance. + + Cache Push + # Cache Pull Discover the essentials of cache retrieval in our cache-pull guide. Speed up your build processes by mastering the art of efficiently pulling cached data. + + Cache Pull + + # How to Share Files Between Build Profiles Seamlessly share files between build profiles with our expert tips. This guide ensures consistent builds across profiles for better integration. + + How to Share Files Between Build Profiles + + # How to Share Files Between Pipelines -Facilitate file sharing between pipelines using our comprehensive strategies. Boost collaboration and pipeline efficiency with this crucial guide. \ No newline at end of file +Facilitate file sharing between pipelines using our comprehensive strategies. Boost collaboration and pipeline efficiency with this crucial guide. + + + How to Share Files Between Pipelines + \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/custom-script.md b/docs/workflows/common-workflow-steps/custom-script.md index e961ff12d..e55b9cc5a 100644 --- a/docs/workflows/common-workflow-steps/custom-script.md +++ b/docs/workflows/common-workflow-steps/custom-script.md @@ -13,7 +13,9 @@ import Screenshot from '@site/src/components/Screenshot'; You can use **Custom Script** steps for additional functionalities in your builds. Appcircle will run the commands in your custom scripts and perform the specified actions. These scripts will be run on the runner and you can use any functionality of the build environment as you need. :::tip + Note that you can put the **Custom Script** component anywhere you want in the workflow. This step is used to add different capabilities to the existing workflow. + ::: @@ -30,10 +32,20 @@ You can find all the parameters required for this step in the table below, with | `Script` | With the **Script** input variable, you can add the script you want to run and run it directly in the selected language. If you leave this input blank, it will proceed to the next step without taking any action. | Optional | :::caution + Note that the **Script** area works according to the selected language variable. If you want to run a script in any language, make sure that you select the language correctly. + ::: -## Custom Script FAQ +--- + +To access the source code of this component, please use the following link: + +https://github.com/appcircleio/appcircle-custom-script-component + +--- + +## FAQ ### How to change JAVA version @@ -209,10 +221,6 @@ Please feel free to edit the following variables according to your own requireme ::: -To access the source code of this component, please use the following link: - -https://github.com/appcircleio/appcircle-custom-script-component/ - ### How to use environment variables along with the `sudo` command? Both user-created and Appcircle-reserved [environment variables](/environment-variables/managing-variables) can be used within a custom script with any required command. But, by default, commands that are triggered with `sudo` will not reach them since the user scope is changed. diff --git a/docs/workflows/common-workflow-steps/danger.md b/docs/workflows/common-workflow-steps/danger.md index cb7480b24..c8c968155 100644 --- a/docs/workflows/common-workflow-steps/danger.md +++ b/docs/workflows/common-workflow-steps/danger.md @@ -71,6 +71,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$DANGER_BITBUCKETSERVER_PASSWORD` | Bitbucket password for the bot user. | Optional | | `$DANGER_BITBUCKETSERVER_HOST` | The host that Bitbucket is running on. For example: `git.corp.com` | Optional | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/export-build-artifacts.md b/docs/workflows/common-workflow-steps/export-build-artifacts.md index f23ba7468..7a8a2f3c8 100644 --- a/docs/workflows/common-workflow-steps/export-build-artifacts.md +++ b/docs/workflows/common-workflow-steps/export-build-artifacts.md @@ -12,19 +12,25 @@ import Screenshot from '@site/src/components/Screenshot'; Exports the specified build artifacts from the build agent to the Appcircle dashboard. The exported files will be available for download in the artifacts section of the completed build. :::danger + Sending applications to **Publish**, **Enterprise App Store**, or **Testing Distribution** will not work without this step. + ::: ### Prerequisites :::info + We recommend using it as the last step in your workflow. + ::: :::danger + Remember, if you set a step to run after this step, artifacts generated after this step **will not be exported**. This step only exports the artifacts produced before it. + ::: ### Download Exported Artifacts @@ -53,6 +59,8 @@ You can find all the parameters required for this step in the table below, with | `$AC_UPLOAD_DIR` | If a folder path is specified, the files in this folder will be exported as artifacts. If a file path is specified, that file will be exported as an artifact. Uploading files with a 0 byte size in the specified path will be skipped. The default folder path is **`$AC_OUTPUT_DIR`**. | Required | | `$AC_DISABLE_UPLOAD_ON_FAIL` | The Delete Artifact for failed build variable is **false** by default. This variable allows you to export artifacts if a build succeeds, so that they do not take up disk space. | Optional | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-export-build-artifacts \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/fastlane.md b/docs/workflows/common-workflow-steps/fastlane.md index 88dafe789..e4b06a340 100644 --- a/docs/workflows/common-workflow-steps/fastlane.md +++ b/docs/workflows/common-workflow-steps/fastlane.md @@ -24,7 +24,9 @@ The workflow steps that need to be executed before running the Fastlane workflow :::caution + Fastlane needs project files to work. If there is no **Git Clone** step in your workflow, it will give an error because it cannot find the relevant files of the project. + ::: ### Input Variables @@ -38,13 +40,16 @@ You can find all the parameters required for this step in the table below, with | `$AC_FASTLANE_DIR` | This path is Fastlane's path in the project. By default, it is AC_REPOSITORY_DIR. If your Fastlane file is in a different location in the repo, please change it. | Required | | `$AC_FASTLANE_LANE` | Fastlane lane. For example: `android deploy` or `ios release` | Required | +--- To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-fastlane-component +--- + -## Fastlane FAQ +## FAQ ### How to run a Fastlane plug-in directly? diff --git a/docs/workflows/common-workflow-steps/file-size-check.md b/docs/workflows/common-workflow-steps/file-size-check.md index 491a763ef..60c0bf859 100644 --- a/docs/workflows/common-workflow-steps/file-size-check.md +++ b/docs/workflows/common-workflow-steps/file-size-check.md @@ -20,7 +20,9 @@ The workflow steps that need to be executed before running the **File Size Check | [**Flutter Build for Android**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps/#flutter-build-for-android) | If your project is an **Android** project using **Flutter**, you should use this step to generate the file before checking the app file size. This step generates **APK** or **AAB** files. | :::danger + If you use a different build step than the ones mentioned above to generate the app, then the **File Size Check** step depends on this particular step. + ::: #### For iOS @@ -47,9 +49,13 @@ You can find all the parameters required for this step in the table below, with | `$AC_ANALYZER_FILESIZE_ACTION` | Specifies whether to issue a warning or fail the workflow if the threshold limit is exceeded. The options are **warn** and **fail**, with the default being **fail**. | Optional | :::caution + Note that this step only controls the size of the application generated according to the size variable you specify. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-filesize-component \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/firebase-app-distribution.md b/docs/workflows/common-workflow-steps/firebase-app-distribution.md index 9eda4b09b..b5568669e 100644 --- a/docs/workflows/common-workflow-steps/firebase-app-distribution.md +++ b/docs/workflows/common-workflow-steps/firebase-app-distribution.md @@ -86,10 +86,6 @@ Confidential information should be entered as a [secret environment variable](/e | `$AC_FIREBASE_GROUPS` | Specifies the Firebase tester groups you want to invite. | Optional | | `$AC_FIREBASE_EXTRA_PARAMETERS` | Specifies extra command line parameters. Enter `--debug` for debug mode. | Optional | -### Output Variables - -The **Firebase App Distribution** step generates no output variables. The step succeeds if the app is distributed successfully; otherwise, it fails. - --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md index 367a66334..ebe3a1249 100644 --- a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md +++ b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md @@ -78,6 +78,8 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_FOD_PLATFORM_TYPE` | Platform type for this mobile assessment. | Required | | `$AC_FOD_FILE_PATH` | Full path of the `IPA` or `APK` file. | Required | +--- + To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/ftp-upload.md b/docs/workflows/common-workflow-steps/ftp-upload.md index 4d1fe8ad3..c97581184 100644 --- a/docs/workflows/common-workflow-steps/ftp-upload.md +++ b/docs/workflows/common-workflow-steps/ftp-upload.md @@ -51,7 +51,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_FTP_SOURCE` | Source file or path to upload. For example: the file path can be set to `$AC_OUTPUT_DIR/Myapp.ipa`. Ensure that the file name is correct.| Required | | `$AC_FTP_TARGET` | The target path is on the FTP server. | Required | - +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/git-clone.md b/docs/workflows/common-workflow-steps/git-clone.md index da447269c..e8314b411 100644 --- a/docs/workflows/common-workflow-steps/git-clone.md +++ b/docs/workflows/common-workflow-steps/git-clone.md @@ -19,13 +19,17 @@ Below is a list of workflow steps that must be completed before executing the ** | [**Activate SSH Private Key**](https://docs.appcircle.io/workflows/common-workflow-steps/#activate-ssh-key) | This step sets up your SSH key on the build machine **if you used one to connect your repository with SSH**. | :::caution + If you have not connected your repo via SSH, the **Git Clone** does not have any dependency on the **Activate SSH Private Key** step. + ::: :::info + We recommend using this step at the beginning of the workflow to avoid any problems in the workflow. + ::: ### Input Variables @@ -35,7 +39,9 @@ You can find all the parameters required for this step in the table below, with :::danger + After connecting the repository, the following [**Reserved Environment Variables**](https://docs.appcircle.io/environment-variables/appcircle-specific-environment-variables), which **Git Clone** uses as input, will be automatically populated. Ensure that the variable you provide has a value if you intend to make any changes. **The required variables must not be left empty**. + ::: | Variable Name | Description | Status | @@ -55,6 +61,8 @@ After connecting the repository, the following [**Reserved Environment Variables |-------------------------------|------------------------------------------------| | `AC_REPOSITORY_DIR` | Specifies the root directory of the cloned repository. This path is automatically generated after the repository is cloned. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-git-clone-component \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md index c4a2d7c09..9fe27ef34 100644 --- a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md +++ b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md @@ -89,10 +89,6 @@ Enter confidential information as a [secret environment variable](/environment-v | `$AC_MAESTRO_PULL_ID` | The ID of the pull request from which the upload originated. | Optional | | `$AC_MAESTRO_CLI_VERSION` | The version of the Maestro CLI is to be downloaded in your CI environment. The default value is the `latest` version. | Optional | -## Output Variables - -The **Maestro Cloud Upload** step does not produce any output variables. The results are shown in the build log. - --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/marathon-cloud.md b/docs/workflows/common-workflow-steps/marathon-cloud.md index dc2b2ee60..8c6de6f5c 100644 --- a/docs/workflows/common-workflow-steps/marathon-cloud.md +++ b/docs/workflows/common-workflow-steps/marathon-cloud.md @@ -48,9 +48,11 @@ The parameters required for the operation of this component are given below with :::danger + **Avoid hard-coding sensitive variables, such as tokens or API keys, directly into the parameters of the step.** We recommend using [**Environment Variables**](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. + ::: | Variable Name | Description | Status | @@ -61,6 +63,8 @@ We recommend using [**Environment Variables**](https://docs.appcircle.io/environ | `$AC_MARATHON_UITEST_RUNNER_APP_PATH` | Specifies the path to the test application binary. This application is generated by the corresponding testing step (**Android Build for UI Testing** or **Xcodebuild for Testing**). The default value is `$AC_TEST_APK_PATH ` for Android or `$AC_UITESTS_RUNNER_PATH` for iOS. | Required | | `$AC_OUTPUT_DIR` | Specifies the path for Marathon Cloud outputs. This path will be automatically defined. Do not change if it is not necessary. | Required | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-marathonlabs-component \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/sonarqube.md b/docs/workflows/common-workflow-steps/sonarqube.md index f55ca5e87..e56367924 100644 --- a/docs/workflows/common-workflow-steps/sonarqube.md +++ b/docs/workflows/common-workflow-steps/sonarqube.md @@ -26,7 +26,9 @@ You can find all the parameters required for this step in the table below, with :::caution + Please note that **SonarQube** is a commercial code quality analysis tool. The parameters required for the scanner to work should be used as [**Enviroment Variables**](https://docs.appcircle.io/environment-variables/) as they may create security vulnerabilities. You can obtain these parameters by contacting your DevOps team. + ::: | Variable Name | Description |Status      | @@ -39,14 +41,18 @@ Please note that **SonarQube** is a commercial code quality analysis tool. The p You can also include your unit/UI test results in the **SonarQube** analysis. :::caution + If you want to include your test results in the **SonarQube** analysis, always run the **SonarQube** step after the test step. + ::: #### iOS Tests :::danger + SonarQube accepts `XML` format files to analyse test results. In order to analyse your test results, do not forget to convert the test results to `XML` format by running the [**Convert Xcresult to HTML/XML**](https://github.com/appcircleio/appcircle-ios-xcresult-convert-html-xml-component) step after the [**Xcodebuild for Unit and UI testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-unit-and-ui-tests) step. + ::: #### Android Tests @@ -55,9 +61,13 @@ If you intend to send the test result file obtained from the Android unit test o :::caution + Ensure that the test result path provided to **SonarQube** as a property matches the test result path generated by the [**Android Unit Tests**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#android-unit-tests) step, and direct the output to that location. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-sonarqube-component \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/testinium.md b/docs/workflows/common-workflow-steps/testinium.md index f6a410818..bf0d69917 100644 --- a/docs/workflows/common-workflow-steps/testinium.md +++ b/docs/workflows/common-workflow-steps/testinium.md @@ -75,7 +75,7 @@ Confidential information should be entered as a [secret environment variable](/e ### Output Variables -Below are the output variables generated by this component: +The outputs resulting from the operation of this component are as follows: diff --git a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md index 9309f2b05..44546ee1b 100644 --- a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md +++ b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md @@ -45,6 +45,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$GOOGLE_APPLICATION_CREDENTIALS` | Specify the path to your Google Service Account JSON file. Upload this file to your environment group under the name `GOOGLE_APPLICATION_CREDENTIALS`. Choose either a **Firebase token** or a **Google Service account**. | Optional | | `$AC_FIREBASE_EXTRA_PARAMETERS` | Extra command line parameters. Enter --debug for debug mode. | Optional | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md index 2677b6962..cc2edda37 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md @@ -11,6 +11,9 @@ import Screenshot from '@site/src/components/Screenshot'; This component runs the `flutter analyze` command in your Flutter project. Please note that it requires the [**Flutter SDK**](https://docs.flutter.dev/get-started/install). ### Prerequisites + +Before running the **Flutter Analyze** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md index a0875ac86..255814ea1 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md @@ -62,6 +62,8 @@ To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-android-flutter-build-component +--- + ## FAQ ### How can I solve the `Out of memory error: Java heap memory` or set the heap memory during the build? diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md index 35fa7733c..d139c4b70 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md @@ -12,15 +12,17 @@ This step makes your Flutter project suitable for the iOS environment and builds ### Prerequisites -:::caution -Once you have compiled your app for Flutter iOS, the native environment will be built. For this reason, this step should be used before the [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export) step. -::: +Before running the **Flutter Build for iOS** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | | [**Flutter Install**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-install) | This step will install the Flutter SDK. If a version is not specified, it will install the latest **stable** version. The **Flutter SDK** package must be installed on the system. For this reason, make sure that **Flutter Build for iOS** is used after the **Flutter Install**. | +:::caution +Once you have compiled your app for Flutter iOS, the native environment will be built. For this reason, this step should be used before the [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export) step. +::: + :::danger @@ -39,6 +41,8 @@ The parameters required for this step to work are given in the table below with | `$AC_FLUTTER_BUILD_MODE` | With this variable, you can add the mode you want to build in the build command. For example: `release`. | Required | | `$AC_FLUTTER_BUILD_EXTRA_ARGS`| You can use this parameter if you want to add an extra parameter to the build command line. | Optional | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-flutter-build-component diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md index e95444240..280b680db 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md @@ -12,7 +12,7 @@ The **Flutter Build for Web** step builds your web application using the [Flutte ### Prerequisites -There are no prerequisites required before using the **​Flutter Build for Web** step. +Before running the **​Flutter Build for Web** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -40,6 +40,8 @@ You can find all the parameters required for this step in the table below, along ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | |------------------------|-------------------------------------| | `AC_FLUTTER_WEB_PATH` | This path is generated after the completion of the **Flutter Build for Web** step and stores the generated web application. | diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md index 43b3e483f..92b2491bc 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md @@ -16,20 +16,26 @@ All Flutter versions and detailed information can be found in the [Flutter repos ### Prerequisites +There are no prerequisites required before using the **Flutter Install** step. + :::caution + These steps depend on Flutter installation and can only be used after the **Flutter Install** step: - [**Flutter Build for iOS**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-build-for-ios) - [**Flutter Build for Android**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-build-for-android) - [**Flutter Analyze**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-analyze) - [**Flutter Test**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-test) - [**Flutter Build for Web**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-build-for-web) + ::: :::danger + The steps specified in the table are steps dependent on the **Flutter Install** step. **If Flutter Install is not used before these steps**, these steps will give a **Flutter SDK not found error**. + ::: @@ -43,15 +49,21 @@ You can find all the parameters required for this step in the table below, with | `$AC_SELECTED_FLUTTER_VERSION`| Specifies the Flutter version to install. Defaults to: `stable`. The version you set in the [Configuration](https://docs.appcircle.io/build/building-flutter-applications/#build-configuration-for-flutter-applications) section will override this setting. | Optional | :::caution + If no specific version is specified, this step will automatically install the latest [**stable**](https://docs.flutter.dev/release/archive?tab=macos) version released by Flutter. + ::: ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | |-------------------------------|------------------------------------------------| | `PATH`| PATH variable that adds the Flutter tool to your workflow. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-flutter-install-component diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md index 6ff1433b9..7e00281be 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md @@ -12,6 +12,8 @@ This component allows you to run [**Flutter Unit Tests**](https://docs.flutter.d ### Prerequisites +Before running the **Flutter Test** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | @@ -20,7 +22,9 @@ This component allows you to run [**Flutter Unit Tests**](https://docs.flutter.d :::danger + This step is particularly dependent on the Flutter Install step. If the Flutter SDK is not installed, the step will give an error that the required command was not found. + ::: ### Input Variables @@ -37,10 +41,13 @@ You can find all the parameters required for this step in the table below, with ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | |-------------------------------|------------------------------------------------| | `AC_TEST_RESULT_PATH` | This path is created after the test results are reported. If you are using the [**Export Build Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step, it can be accessed directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md index 4eac2aaa5..145dd8afa 100644 --- a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md +++ b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md @@ -21,7 +21,9 @@ With this step, you can send your `IPA` and `dSYM` files to the [App Center](htt :::caution + Note that if you do not use this step after the [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export), Appcircle will not find **IPA** and **dSYM** files to distribute to the **App Center**. + ::: ### Input Variables @@ -31,9 +33,11 @@ Note that if you do not use this step after the [**Xcodebuild for Devices**](htt :::danger + **Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** We recommend using [Environment Variables](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. + ::: @@ -52,6 +56,8 @@ We recommend using [Environment Variables](https://docs.appcircle.io/environment | `$AC_APPCENTER_VERSION` | The latest version will be used if no version is set. | Optional | | `$AC_APPCENTER_EXTRA` | Extra command line arguments for App Center. For example, add `--debug` for verbose logs. | Optional | +--- + To access the source code of this component, please use the following link: [https://github.com/appcircleio/appcircle-ios-appcenter-distribute-component](https://github.com/appcircleio/appcircle-ios-appcenter-distribute-component) \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index f545aca82..abe2a68bc 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -23,7 +23,9 @@ The workflow steps that need to be executed before running the **Appdome Build-2 | [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) | The app required for this step is generated by the **Xcodebuild for Devices** (or alternative build steps). | :::danger + If a step other than the **Xcodebuild for Devices** step is used to build or sign the app, then the **Appdome Build-2Secure for iOS** step depends on this step. + ::: @@ -35,9 +37,11 @@ This stepper needs the necessary parameters to operate. You can find all paramet :::danger + **Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. + ::: | Variable Name | Description | Status | @@ -57,7 +61,9 @@ We recommend using [Environment Variables](/environment-variables/) groups for s The outputs that can result from the operation of this component are listed as follows: :::caution + To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. + ::: | Variable Name | Description | Status | @@ -65,3 +71,8 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w | `AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured .ipa file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing` | Required | | `AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | TLocal path of the .sh sign script file. Available when `Signing Method` set to `Auto-Dev-Signing` | Required | | `AC_APPDOME_CERTIFICATE_PATH` | Local path of the Certified Secure Certificate `.pdf` file | Required | + +--- + +To access the source code of this component, please use the following link: +[https://github.com/appcircleio/appcircle-ios-appdome-component](https://github.com/appcircleio/appcircle-ios-appdome-component) diff --git a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md index 8bd683055..383abc47d 100644 --- a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md +++ b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md @@ -42,6 +42,7 @@ You can find all the parameters required for this step in the table below, with | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj` | Required | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md index a9c11f249..7a146c13c 100644 --- a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md @@ -11,15 +11,21 @@ import Screenshot from '@site/src/components/Screenshot'; With the Azure DevOps Bot for Swiftlint integration, you can analyze your [**SwiftLint**](https://github.com/realm/SwiftLint/) and post the report details under the opened PR. You can also modify the PR status. :::info + This component will work in builds that are automatically triggered by a configured trigger. To achieve this, you need to open a PR and set up the trigger. Further information for **Trigger Build**, please follow the [documantation](/build/build-process-management/build-manually-or-with-triggers/). + ::: :::caution + If there are warnings or errors in the SwiftLint report, this workflow step will fail and stop the build. + ::: :::danger + For this component to work, a PR must be opened, and a trigger must be set up based on this PR. If the build is triggered manually, the component will not function. + ::: ### Prerequisites @@ -39,9 +45,11 @@ This component needs some parameters to operate. You can find the required param :::danger + **Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. + ::: | Variable Name | Description | Status | @@ -55,6 +63,8 @@ We recommend using [Environment Variables](/environment-variables/) groups for s | `$AC_DOMAIN_NAME` | Specifies the domain name of Appcircle. The default value is `my.appcircle.io`, which is the domain for Appcircle Cloud. | Required | | `$AC_AZURE_API_VERSION` | Specifies the version of the Azure API, for example: `7.1`. Refer to the [REST API versioning](https://learn.microsoft.com/en-us/azure/devops/integrate/concepts/rest-api-versioning) document for more information. | Required | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-azure-bot-for-swiftlint-component diff --git a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md index a455abf42..e5456cba2 100644 --- a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md +++ b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md @@ -13,6 +13,8 @@ Run your [**XCUI**](https://developer.apple.com/documentation/xctest/user_interf ### Prerequisites +Before running the **BrowserStack App Automate (XCUI)** step, you must complete certain prerequisites, as detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) | After the [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) step runs, the test IPA paths (`$AC_TEST_IPA_PATH` and `$AC_UITESTS_RUNNER_PATH`) will be created automatically. So that the **BrowserStack** component depends on these paths. | @@ -20,7 +22,9 @@ Run your [**XCUI**](https://developer.apple.com/documentation/xctest/user_interf :::danger + In the build step, if there is no **Xcodebuild Build for Testing** step before **BrowserStack**, **BrowserStack** will throw an **error** and **break the pipeline** because it cannot find the paths that your step depends on. + ::: ### Input Variables @@ -30,7 +34,9 @@ You can find all the parameters required for this step in the table below, with :::danger + Do not specify the **Access Key** directly in a hard coded format in steps. Please use [**Environment Variables**](https://docs.appcircle.io/environment-variables/) when using potentially *sensitive variables* like this. + ::: | Variable Name | Description | Status | @@ -42,6 +48,8 @@ Do not specify the **Access Key** directly in a hard coded format in steps. Plea | `$AC_BROWSERSTACK_PAYLOAD` | `$AC_BROWSERSTACK_APP_URL` and `$AC_BROWSERSTACK_TEST_URL` will be auto generated. Please check the [documentation](https://www.browserstack.com/docs/app-automate/api-reference/xcuitest/builds#execute-a-build) for more details about the payload. | Optional | | `$AC_BROWSERSTACK_TIMEOUT` | **BrowserStack** plans a timeout in seconds. If there is any problem in BrowserStack, these variables will break the pipeline after a certain time. The default variable is **600 seconds**. | Required | +--- + To access the source code of this component, please use the following link: [https://github.com/appcircleio/appcircle-browserstack-xcui-component](https://github.com/appcircleio/appcircle-browserstack-xcui-component) \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/carthage.md b/docs/workflows/ios-specific-workflow-steps/carthage.md index 802972e83..a9d631294 100644 --- a/docs/workflows/ios-specific-workflow-steps/carthage.md +++ b/docs/workflows/ios-specific-workflow-steps/carthage.md @@ -35,6 +35,8 @@ You can find all the parameters required for this step in the table below, with | `$AC_CARTFILE_PATH` | Specifies the path where the Cartfile resides. Defaults to the repository directory. **DO NOT** include Cartfile, this is only the path. **This value will be appended** to `$AC_REPOSITORY_DIR`. **Example:** `./` or `./subpath-to-cartfile/` | Optional | | `$AC_CARTHAGE_FLAGS` | Specifies additional flags after the Carthage command. The default value is empty. **For Xcode 12 and above, make sure to include** `--use-xcframeworks` **here**. To shorten the build time, make sure to specify the platform: `--platform iOS`. Example usage: `--platform iOS --use-xcframeworks` | Optional | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-carthage-component \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md index a6025cfd8..4d8aa27d3 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md @@ -40,6 +40,7 @@ You can find all the parameters required for this step in the table below, with | `$AC_REPOSITORY_DIR` | Specifies the directory where the repository is cloned. This path is generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Optional | | `$AC_COCOAPODS_VERSION` | Specifies the CocoaPods version. If you need a specific version, provide it here as hardcoded, and the system will automatically install that version. | Optional | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md index 573c2e4ac..12920ff5a 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md @@ -33,13 +33,19 @@ You can find all the parameters required for this step in the table below, with | `$AC_COCOAPODS_VERSION` | Specifies the CocoaPods version. If there is a specific version you want to use, give it here as hardcoded, and the system will automatically install the given version. | Optional | :::info + Please note that the CocoaPods Install step uses the default system [**CocoaPods version**](https://docs.appcircle.io/infrastructure/ios-build-infrastructure#ios-build-agent-stacks). If you want to use a specific version, please enter it hardcoded in the CocoaPods Version parameter in the step. + ::: :::danger + Remember, if the project extension is not **.xcworkpace**, the pod install step will not work as expected. In the Configuration tab, make sure that the extension in the project path is **.xcworkspace**. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-cocoapods-component diff --git a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md index dbb4f78da..8fd076d1e 100644 --- a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md +++ b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md @@ -12,12 +12,17 @@ After the [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/conti ### Prerequisites + +Before running the **Convert Xcresult to HTML/XML** step, you must complete certain prerequisites, as detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/continuous-testing/running-ios-unit-and-ui-tests) | This step allows you to run unit and UI tests on your project. After this step runs, the related path, `AC_TEST_RESULT_PATH` will be generated automatically. | :::caution + Please note that if you do not run **Xcodebuild for Unit and UI Tests** before this step, the step will produce an error because there will be no test result file to convert. + ::: @@ -39,14 +44,20 @@ The parameters required for the operation of this stepper are given below with e ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | |-------------------------------|-------------------------------------| | `AC_CONVERTED_TEST_RESULT_PATH` | Specifies the path where the converted result is stored. Users can access this path via this variable. Additionally, it will be available for download in the [**Download Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. | :::caution + To view the converted test reports on the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-xcresult-convert-html-xml-component \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md b/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md index 61b87c2f3..b4be0d4ab 100644 --- a/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md +++ b/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md @@ -12,7 +12,7 @@ This step allows to upload your debug symbols to [**Firebase Crashlytics**](http ### Prerequisites -The workflow steps that need to be executed before running the `Firebase Upload dSYM` workflow step, along with their respective reasons, are listed in the table below. +The workflow steps that need to be executed before running the **Firebase Upload dSYM** workflow step, along with their respective reasons, are listed in the table below. | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -21,7 +21,9 @@ The workflow steps that need to be executed before running the `Firebase Upload :::danger + If this step is not used after **Xcodebuild for Devices**, the pipeline will give error. Because the dSYM file is generated after the project is archived. + ::: ### Input Variables @@ -36,16 +38,20 @@ You can find all the parameters required for this step in the table below with t | `$AC_FIREBASE_CRASHLYTICS_PATH` | This path parameter specifies the path of the generated dSYM file. | Required | :::info + Crashlytics paths change depending on the platform. According to the mobile application platform you are working on, you need to provide one of the following paths here. -|Project Type|Crashlytics Paths for Platforms| -|------------|----| -|Native iOS CocoaPods|$AC_REPOSITORY_DIR/Pods/FirebaseCrashlytics/upload-symbols| -|Native iOS SPM|$HOME/Library/Developer/Xcode/DerivedData/**/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/upload-symbols| -|React Native iOS|$AC_REPOSITORY_DIR/ios/Pods/FirebaseCrashlytics/upload-symbols| -|Flutter iOS|$AC_REPOSITORY_DIR/ios/Pods/FirebaseCrashlytics/upload-symbols| +| Project Type | Crashlytics Paths for Platforms | +|----------------------|-------------------------------------------------------------------------------------------------------------------| +| Native iOS CocoaPods | $AC_REPOSITORY_DIR/Pods/FirebaseCrashlytics/upload-symbols | +| Native iOS SPM | $HOME/Library/Developer/Xcode/DerivedData/**/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/upload-symbols | +| React Native iOS | $AC_REPOSITORY_DIR/ios/Pods/FirebaseCrashlytics/upload-symbols | +| Flutter iOS | $AC_REPOSITORY_DIR/ios/Pods/FirebaseCrashlytics/upload-symbols | + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-firebase-dsym-upload-component \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md index 2afdebb26..060d00f9d 100644 --- a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md +++ b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md @@ -13,8 +13,12 @@ For more detailed information on **iOS Certificates and Provisioning Profiles**, ### Prerequisites +Before running the **Install Certificates and Provisioning Profiles** step, you must complete certain prerequisites, as detailed in the table below: + :::info + If you are using an automatic code sign, you can remove this step. Since automatic code signing is managed by Xcode, this step will not be needed. + ::: | Prerequisite Workflow Step | Description | @@ -22,7 +26,9 @@ If you are using an automatic code sign, you can remove this step. Since automat | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | Clone your repository to the runner machine. Use the Install Certificates and Provisiong Profiles step after this step. This step will clone your repository to be able to use provisioning profiles and certificates. | :::danger + Please remember. If you are using **manual sign**, you should definitely use this step and run it after the **Git Clone** step. + ::: @@ -52,6 +58,8 @@ The output parameters after this step is executed are as follows: | `AC_KEYCHAIN_PATH` | A path is created after the certificate is added to the current runner's keychain. | | `AC_KEYCHAIN_PASSWORD` | After this certificate is added to the keychain, the password assigned to the keychain | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-install-certificates-and-profiles-component diff --git a/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md b/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md index 58b230608..2d8c15ebb 100644 --- a/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md +++ b/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md @@ -12,6 +12,7 @@ The **iOS Increment Build and Version Number** step is controlled by **iOS Versi - [**Understanding iOS Versioning**](/versioning/ios-version) +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/slather.md b/docs/workflows/ios-specific-workflow-steps/slather.md index 3895f524e..bbb9623da 100644 --- a/docs/workflows/ios-specific-workflow-steps/slather.md +++ b/docs/workflows/ios-specific-workflow-steps/slather.md @@ -12,6 +12,8 @@ This step converts Xcode's test results to different formats by using [**Slather ### Prerequisites +Before running the **Slather** step, you must complete certain prerequisites, as detailed in the table below: + | Prerequisite Workflow Step | Description | |------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your repository. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | @@ -21,7 +23,9 @@ This step converts Xcode's test results to different formats by using [**Slather :::danger + **Slather** component needs test results in `.xcresult` format to work. Therefore, make sure that the tests of the project are run. Otherwise, **Slather** will throw an error for not finding the file and the pipeline will break. + ::: ## Input Variables @@ -41,6 +45,7 @@ You can find all the parameters required for this step in the table below, with | `$AC_CONFIGURATION_NAME`| If you have a configuration that you want to specify while **Slather** is running, you can add it to the command line with the **Configuration** parameter. | Optional | | `$AC_SLATHER_OPTIONS` | If you want to add an extra command to the command line, you can do it with the **Extra Option** variable. | Optional | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/swiftlint.md b/docs/workflows/ios-specific-workflow-steps/swiftlint.md index 8b919c775..2e93552a7 100644 --- a/docs/workflows/ios-specific-workflow-steps/swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/swiftlint.md @@ -21,12 +21,17 @@ Remember, SwiftLint must be used after the following steps in order to work as e :::danger + If you are using **CocoaPods**, note that this step is dependent on the [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) step. Otherwise, the SwiftLint component will **fail**, and the **pipeline will break.** + ::: + :::caution + If you are using **Swift Package Manager (SPM)**, do not use this step. SPM packages will be compiled in other steps that work with **Xcode**, such as [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export). If you have SPM in your project and you are using the SwiftLint component in your workflow, the Linter component will give an error because it cannot find the required dependencies. + ::: ### Input Variables @@ -47,10 +52,14 @@ You can also customize your SwiftLint step with the options in the component. Yo ### Output Variables +The output parameters after this step is executed are as follows: + | Variable Name | Description | |-------------------------------|------------------------------------------------| | `AC_LINT_OUTPUT_PATH` | The path of the SwfitLint results output file. After SwiftLint runs, all results will be written in a .txt file. It can be found in the download artifacts. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-swiftlint-component \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md b/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md index 190f563c8..69fd7d81b 100644 --- a/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md @@ -47,6 +47,7 @@ The outputs resulting from the operation of this component are as follows: | -------------------------- | ---------------------------------------------------- | | `AC_TEST_REPORT_JSON_PATH` | Specifies the path of the JSON report. | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md index eb32e7ae8..4b1c13c48 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md @@ -44,6 +44,7 @@ You can find all the parameters required for this step in the table below, with | `$AC_TUIST_PATH` | Specifies the path to the directory containing the project definition. This path is automatically generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_TUIST_COMMANDS` | Specifies the Tuist Commands to be able to run specific Tuist Commands. For example; `tuist test` or `tuist build`. | Required | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-install.md b/docs/workflows/ios-specific-workflow-steps/tuist-install.md index 1444fce24..0d5722c90 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-install.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-install.md @@ -73,6 +73,7 @@ For this reason, iOS apps using Tuist versions `1.x` or `2.x` are not supported | `$AC_TUIST_PATH` | Specifies the path to the directory containing the project definition. This path is automatically generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_TUIST_VERSION` | Specifies the Tuist version. If not specified, the latest version of Tuist will be installed. | Optional | +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/ios-specific-workflow-steps/xcode-select.md b/docs/workflows/ios-specific-workflow-steps/xcode-select.md index f57dcd7be..742068042 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcode-select.md +++ b/docs/workflows/ios-specific-workflow-steps/xcode-select.md @@ -33,16 +33,18 @@ Please **don't forget** to select the **Xcode version** from [Configuration](htt :::info + Appcircle provides new versions of Xcode (including beta versions) within 24 hours after they are released. + ::: -:::caution -### Pool-Based Xcode Version Selection +:::caution Pool-Based Xcode Version Selection A version other than the Xcode versions on the configuration page should not be entered manually as the Xcode select workflow argument. Because the Xcode versions on the configuration page are the versions installed on runners. Entering an unavailable Xcode version may cause the build to fail. You can review the documentation for detailed information about the Xcode version selection [here](/self-hosted-appcircle/self-hosted-runner/configure-runner/manage-pools/#pool-based-xcode-version-selection). + ::: ### Input Variables @@ -54,6 +56,8 @@ You can find all the parameters required for this step in the table below, with | `$AC_XCODE_LIST_DIR` | Specifies the directory with the Xcode versions. Xcode versions are located under the /Volumes directory and selected according to the given version. | Required | | `$AC_XCODE_VERSION` | Specifies the xcode version. This variable comes from Configuration. | Required | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-xcode-select-component diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md index 702bdd146..f58a5cf67 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md @@ -11,7 +11,9 @@ import Screenshot from '@site/src/components/Screenshot'; This step builds your application for iOS devices in ARM architecture, which is required for the [**Sharing With Testers**](/testing-distribution/create-or-select-a-distribution-profile) feature or any other means of iOS distribution. :::info + This step is the archive and export step. When the step is completed, the `.ipa` file of the application is generated. + ::: ### Prerequisites @@ -25,8 +27,10 @@ The workflow steps that need to be executed before running this step, along with | [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) | This step installs all pod dependencies for project. **Xcodebuild for Devices** should be used after this step. If you use SPM (Swift Package Manager), it is not necessary to use. | :::danger + This step should always follow steps that may affect Archive and Export, such as Xcode Select and Cocoapods Install. + ::: ### Input Variables @@ -57,16 +61,22 @@ You can find all the parameters required for this step in the table below, with ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | | --------------------------- | --------------------------------------------------------- | | `$AC_ARCHIVE_PATH` | This is the path created after retrieving the archive. | | `$AC_ARCHIVE_METADATA_PATH` | This is the path created after the metadata is generated. | | `$AC_EXPORT_DIR` | This is the path created when exporting. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-build-sign-component +--- + ## FAQ ### Adding Additional Command to Xcodebuild for Devices Step @@ -82,7 +92,9 @@ To address the need to add a new command after completing the `xcodebuild` comma - In the Ruby code, you can add the required codes to the end of the `xcodebuild` command. :::caution + Before running the script, some variables must be changed, and new variables must be added to the custom script. + ::: First, the `output_path` global variable should be changed like below in global variables. @@ -111,7 +123,9 @@ $compiler_index_store_enable = AC_COMPILER_INDEX_STORE_ENABLE ``` :::caution + You should find the line with `compiler_index_store_enable` and replace it with the above statement. + ::: After these variables were set. There is an `archive()` function in the Ruby code. First, find the function in the code. diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md index 342dcfa24..62392c28e 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md @@ -22,7 +22,9 @@ Use this step after the **Xcode Select** and **CocoaPods Install** (if you use :::caution + If you use SPM (Swift Package Manager), Xcode will manage itself when a project is built. The **CocoaPods Install** step is not necessary. + ::: ### Input Variables @@ -50,10 +52,14 @@ Be aware of which OS version you used; the simulator type should match that OS v ### Output Variables +The outputs resulting from the operation of this component are as follows: + | Variable Name | Description | |-------------------------------|------------------------------------------------| | `AC_SIMULATOR_APP_PATH` | Simulator app path. You can reach the Simulator app from this path, and it will be exported, it can be downloaded from the download artifacts. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-build-simulator \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md index 0b8a2c9e5..0bf44f401 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md @@ -22,7 +22,9 @@ In order for this step to work correctly, it must be used after the two steps li :::caution + If you use SPM (Swift Package Manager), Xcode will manage itself when a project build. The **CocoaPods Install** step is not necessary. + ::: ### Input Variables @@ -54,6 +56,8 @@ This component outputs some important parameters after running. | `AC_XCTEST_ZIP_PATH` | Path to the IPA version of the Xctests. You can access it directly via this path. | | `AC_TEST_IPA_PATH` | This path holds the IPA file created for running tests and sending the IPA file to test automation tools. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-ios-build-for-testing \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md index eea1b0ca4..537bef4a2 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md @@ -17,6 +17,9 @@ This step does not generate **IPA**, it only runs tests within the project. ::: ### Prerequisites + +Before you run the **Xcodebuild for Unit and UI Testing** step, you must complete certain prerequisites, as detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------------------------------------------------|-------------------------------------------------| | [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository must be cloned to initiate the unit and UI testing process. Following the clone, this step will run the tests and create the `AC_REPOSITORY_DIR` variable. | diff --git a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md index e06bde4f6..1eee301cb 100644 --- a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md +++ b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md @@ -51,10 +51,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_APPCENTER_EXTRA` | Extra command line arguments for appcenter. For example, add `--debug` for verbose logs. | Optional | -### Output Variables - -The **App Center CodePush** step does not produce any output variables. The results are shown in the build log. - +--- To access the source code of this component, please use the following link: diff --git a/docs/workflows/react-native-specific-workflow-steps/node-install.md b/docs/workflows/react-native-specific-workflow-steps/node-install.md index 620f00616..4e9f54377 100644 --- a/docs/workflows/react-native-specific-workflow-steps/node-install.md +++ b/docs/workflows/react-native-specific-workflow-steps/node-install.md @@ -11,12 +11,17 @@ import Screenshot from '@site/src/components/Screenshot'; React Native applications commonly depend on certain Node modules. This workflow step makes sure that you have the required Node version installed in the build agent to build your React Native application. ### Prerequisites + +Before running the **Install Node** step, you must complete certain prerequisites, as detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) | Clone the selected repository to the build machine. Please use the [**Install Node**](https://docs.appcircle.io/workflows/react-native-specific-workflow-steps#install-node) step after this step. | :::caution + Please note that this step should be used before steps that need the **npm/yarn Commands** step. To avoid any problems, you can run this step after the **Git Clone** step. + ::: @@ -32,9 +37,13 @@ You can find all the parameters required for this step in the table below, with | `$AC_SELECTED_NODE_VERSION` | This step takes only the **node version** variable. You can specify the version directly in the step if you wish. Or you can get it from build [**Configurations**](https://docs.appcircle.io/build/building-react-native-applications#build-configuration-for-react-native-ios-applications). | Optional | :::caution + If you do not specify any specific version for the **Install Node** step. The latest version will be installed automatically. + ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-node-install-component \ No newline at end of file diff --git a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md index e90754aab..5635c612d 100644 --- a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md +++ b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md @@ -31,6 +31,8 @@ This step contains different variables. It needs these variables to work. The ta | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | | `$AC_NPM_COMMAND_ARGS` | The NPM command to run. You can add different command parameters directly. The default is: `npm/yarn install` | Optional | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-npm-yarn-component diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md index 42d58c614..f1fb59936 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md @@ -141,6 +141,8 @@ The outputs resulting from the operation of this component are as follows: | --------------------- | ------------------------------------------------------------------------------------------------------------ | | `AC_TEST_RESULT_PATH` | The output path for the `e2e-report.xml` file. This environment variable can be utilized in subsequent steps. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-react-native-ui-test-component diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md index 0e4dd05e3..179d68ec7 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md @@ -66,6 +66,8 @@ Appcircle does **not** currently support **test coverage** calculation for React ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-react-native-unit-test-component diff --git a/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md b/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md index 516a7f06d..1466c492b 100644 --- a/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md +++ b/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md @@ -54,6 +54,8 @@ The outputs resulting from the operation of this component are as follows: | -------------------------- | -------------------------------------- | | `AC_TEST_REPORT_JSON_PATH` | Specifies the path of the JSON report. | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-test-report-component From 25950267c0c634b3eae4c3a2a359344d8c2a826d Mon Sep 17 00:00:00 2001 From: boztopuz Date: Thu, 14 Nov 2024 12:26:42 +0300 Subject: [PATCH 03/10] Improved the template for wf step docs --- .../android-build-for-ui-testing.md | 6 +- .../android-build.md | 6 +- .../android-dependency-report.md | 8 ++- .../android-sign.md | 9 ++- .../android-unit-tests.md | 8 ++- .../app-center-android-distribution.md | 4 +- .../app-post-processor.md | 7 +- .../appdome-build-to-secure-for-android.md | 6 +- .../appsweep-mobile-security-testing.md | 6 +- .../azure-bot-for-detekt-report.md | 5 +- .../browserstack-app-automate-espresso.md | 5 +- .../bundle-universal-apk.md | 6 +- .../android-specific-workflow-steps/detekt.md | 4 +- .../firebase-test-lab.md | 4 +- .../gradle-runner.md | 4 +- .../android-specific-workflow-steps/lint.md | 6 +- .../post-processor.md | 66 ------------------- .../test-reports-for-android.md | 6 +- .../wait-for-android-emulator.md | 4 +- .../active-ssh-private-key.md | 4 +- .../add-badge-app-icon.md | 4 +- .../common-workflow-steps/appium-server.md | 6 +- .../authenticate-with-netrc.md | 4 +- .../aws-device-farm-and-deploy.md | 4 +- .../common-workflow-steps/azure-board.md | 4 +- .../build-cache/cache-pull.md | 4 +- .../build-cache/cache-push.md | 4 +- .../common-workflow-steps/custom-script.md | 6 +- .../workflows/common-workflow-steps/danger.md | 4 +- .../data-theorem-mobile-secure.md | 4 +- .../export-build-artifacts.md | 8 ++- .../common-workflow-steps/fastlane.md | 4 +- .../common-workflow-steps/file-size-check.md | 7 +- .../firebase-app-distribution.md | 4 +- .../fod-mobile-assesment.md | 3 +- .../common-workflow-steps/ftp-upload.md | 6 +- .../common-workflow-steps/git-clone.md | 6 +- .../common-workflow-steps/jira-comment.md | 4 +- .../maestro-cloud-upload.md | 4 +- .../common-workflow-steps/marathon-cloud.md | 6 +- .../publish-release-notes.md | 2 +- .../repeato-test-runner.md | 4 +- .../set-environment-variable.md | 9 +-- .../snyk-scan-security.md | 6 +- .../common-workflow-steps/sonarqube.md | 5 +- .../common-workflow-steps/testinium.md | 6 +- .../upload-files-to-amazon-s3.md | 8 ++- .../firebase-deployment.md | 4 +- .../flutter-analyze.md | 4 +- .../flutter-build-for-android.md | 6 +- .../flutter-build-for-ios.md | 6 +- .../flutter-build-for-web.md | 6 +- .../flutter-install.md | 6 +- .../flutter-test.md | 4 +- .../appcenter-ios-distribution.md | 4 +- .../appdome-build-to-secure-for-ios.md | 6 +- .../audit-permission-change.md | 2 +- .../azure-bot-for-swiftlint.md | 4 +- .../browserstack-app-automation.md | 2 +- .../ios-specific-workflow-steps/carthage.md | 11 +++- .../cocoapods-deintegrate.md | 2 +- .../cocoapods-install.md | 4 +- .../convert-xcresult-to-xml-html.md | 4 +- .../firebase-upload-dsym.md | 4 +- .../install-certificates-provisions.md | 4 +- .../ios-specific-workflow-steps/slather.md | 2 +- .../ios-specific-workflow-steps/swiftlint.md | 6 +- .../test-reports-for-ios.md | 6 +- .../tuist-commands.md | 4 +- .../tuist-install.md | 4 +- .../xcode-select.md | 8 ++- .../xcodebuild-for-devices.md | 6 +- .../xcodebuild-for-ios-simulator.md | 6 +- .../xcodebuild-for-testing.md | 6 +- .../xcodebuild-for-unit-and-ui-test.md | 15 ++++- .../app-center-code-push.md | 2 +- .../node-install.md | 2 +- .../npm-yarn-commands.md | 4 +- .../react-native-ui-test.md | 4 +- .../react-native-unit-test.md | 6 +- .../test-reports-react-native.md | 4 +- 81 files changed, 234 insertions(+), 244 deletions(-) delete mode 100644 docs/workflows/android-specific-workflow-steps/post-processor.md diff --git a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md index eb742cb32..0b2bf3923 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md +++ b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md @@ -12,7 +12,7 @@ The **Android Build for UI Testing** workflow step is tailored to [build your An ### Prerequisites -The workflow steps that need to be executed before running the **Android Build for UI Testing** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Android Build for UI Testing** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -45,7 +45,7 @@ The **[Firebase Test Lab for Android](https://docs.appcircle.io/continuous-testi ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Build for UI Testing** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -57,7 +57,7 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | ------------------- | -------------------------------------------------------------------------------------------------------------------- | diff --git a/docs/workflows/android-specific-workflow-steps/android-build.md b/docs/workflows/android-specific-workflow-steps/android-build.md index da04dc3f3..8c09b617c 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build.md +++ b/docs/workflows/android-specific-workflow-steps/android-build.md @@ -12,7 +12,7 @@ The Appcircle Android Build step is designed to build your Android application f ### Prerequisites -The workflow steps that need to be executed before running the **Android Build** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Android Build** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -22,7 +22,7 @@ The workflow steps that need to be executed before running the **Android Build** ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Build** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -55,7 +55,7 @@ If you are using Gradle 4.3 and above in your project, you can just use the `--s ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | -------------- | ---------------------------------------------------------------------------------------------------------------------------- | diff --git a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md index f2b70d39f..2433959af 100644 --- a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md +++ b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md @@ -14,7 +14,7 @@ Rendering the dependency tree is particularly useful if you’d like to identify ### Prerequisites -The workflow steps that need to be executed before running the **Android Dependency Report** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Android Dependency Report** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -24,7 +24,7 @@ The workflow steps that need to be executed before running the **Android Depende ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Dependency Report** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -37,7 +37,7 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | ------------------------------------ | ---------------------------------------------------------------------- | @@ -51,6 +51,8 @@ If you wish to review or download the Android Dependencies Report, you can find ::: +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-dependency-report.git diff --git a/docs/workflows/android-specific-workflow-steps/android-sign.md b/docs/workflows/android-specific-workflow-steps/android-sign.md index c30360fa8..20fbc0bc7 100644 --- a/docs/workflows/android-specific-workflow-steps/android-sign.md +++ b/docs/workflows/android-specific-workflow-steps/android-sign.md @@ -17,7 +17,8 @@ This step follows the [**Android Build**](https://docs.appcircle.io/workflows/an ::: ### Prerequisites -The workflow steps that need to be executed before running the **Android Build** workflow step, along with their respective reasons, are listed in the table below. + +Before running the **Android Sign** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -39,7 +40,8 @@ To share the signed apps created as an output of this step or to view them on th ::: ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Sign** are as follows: + +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -54,7 +56,8 @@ For each component, specific input variables are required for its operation on y | `$AC_V2_SIGN` | Defaults to false. Set true if the signature should be done using apksigner instead of jarsigner. For more information, [Apps targeting Android 11 require APK Signature Scheme v2](https://developer.android.com/about/versions/11/behavior-changes-11#minimum-signature-scheme). | Optional | ### Output Variables -The outputs that can result from the operation of this component are listed as follows. + +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md index 4e4d1d35e..7181aa9a5 100644 --- a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md +++ b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md @@ -14,7 +14,7 @@ Please check out this document for more information: [Running Android Unit Tests ### Prerequisites -The workflow steps that need to be executed before running the **Android Unit Tests** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Android Unit Tests** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -23,14 +23,16 @@ The workflow steps that need to be executed before running the **Android Unit Te :::danger + If you wish to view the test results on Appcircle's Test Reports page, it is essential to use the [Test Reports](https://github.com/appcircleio/appcircle-test-report-component) step after the **Android Unit Tests**. Please check out this document for more information: [Generating Test Report](https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) + ::: ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Unit Tests** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -43,7 +45,7 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | ---------------------- | -------------------------------------------------------------- | diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index cc50e1e06..f71344e44 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -25,7 +25,7 @@ For more details, please refer to the following links: ### Prerequisites -The workflow steps that need to be executed before running the **App Center Android Distribute** workflow step, along with their respective reasons, are listed in the table below. +Before running the **App Center Android Distribute** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -42,7 +42,7 @@ If a step other than the **Android Build** or **Android Sign** step is used to b ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for **App Center Android Distribute** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/android-specific-workflow-steps/app-post-processor.md b/docs/workflows/android-specific-workflow-steps/app-post-processor.md index 601a7d486..0365de64f 100644 --- a/docs/workflows/android-specific-workflow-steps/app-post-processor.md +++ b/docs/workflows/android-specific-workflow-steps/app-post-processor.md @@ -10,10 +10,13 @@ import Screenshot from '@site/src/components/Screenshot'; This step performs the necessary system operations to identify and process the Android output binary files. :::warning + This step also verifies whether the app is signed or not. If this step is not included in your Workflow or if it is determined that there is no signed app as a result of this step, __the app cannot be distributed__. + ::: ### Prerequisites + The workflow steps that need to be executed before running the **Android App Post-Processor** workflow step, along with their respective reasons, are listed in the table below. | Prerequisite Workflow Step | Description | @@ -31,10 +34,12 @@ If a step other than the **Android Build** or **Android Sign** step is used to b ::: ### Input Variables + There is no need to enter an input for this component. It will process Android files under the output directory (`$AC_OUTPUT_DIR`). ### Output Variables -The outputs that can result from the operation of this component are listed as follows: + +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md index 11afce646..8be72384e 100644 --- a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md @@ -16,7 +16,7 @@ https://appcircle.io/blog/elevate-your-mobile-app-security-with-appdome-integrat ### Prerequisites -The workflow steps that need to be executed before running the **Appdome Build-2Secure for Android** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Appdome Build-2Secure for Android** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -33,7 +33,7 @@ If a step other than the **Android Build** or **Android Sign** step is used to b ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for **Appdome Build-2Secure for Android** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -57,7 +57,7 @@ Confidential information should be entered as a [secret environment variable](ht ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index a14ab5810..7bc6f0a48 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -14,7 +14,7 @@ The Appcircle **AppSweep Mobile Security Testing** step allows you to comprehens ### Prerequisites -The workflow steps that need to be executed before running the **AppSweep Mobile Security Testing** workflow step, along with their respective reasons, are listed in the table below. +Before running the **AppSweep Mobile Security Testing** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | @@ -24,7 +24,7 @@ The workflow steps that need to be executed before running the **AppSweep Mobile ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for **AppSweep Mobile Security Testing** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -44,7 +44,7 @@ We recommend using [Environment Variables](https://docs.appcircle.io/environment ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | ------------------ | ------------------------------------------------------------- | diff --git a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md index a17fc83d0..451d3d651 100644 --- a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md +++ b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md @@ -21,7 +21,7 @@ For more information, refer to the Appcircle blog post about Danger: ### Prerequisites -The workflow steps that need to be executed before running the **Azure DevOps Bot for Detekt Report** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Azure DevOps Bot for Detekt Report** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|--------------------------------------------------| @@ -30,7 +30,8 @@ The workflow steps that need to be executed before running the **Azure DevOps Bo ### Input Variables -For each step, specific input variables are required for its operation on your system. The input variables necessary for the **Azure DevOps Bot for Detekt Report** are as follows: + +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md index a1bfd4daa..ac0524f83 100644 --- a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md +++ b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md @@ -14,7 +14,7 @@ The Appcircle **BrowserStack App Automate - Espresso** step allows you to run au ### Prerequisites -The workflow steps that need to be executed before running the **BrowserStack App Automate - Espresso** workflow step, along with their respective reasons, are listed in the table below. +Before running the **BrowserStack App Automate - Espresso** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -23,7 +23,8 @@ The workflow steps that need to be executed before running the **BrowserStack Ap ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **BrowserStack App Automate - Espresso** are as follows: + +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md index 45f27ec89..a2b0ed15c 100644 --- a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md +++ b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md @@ -14,7 +14,7 @@ For additional details, please refer to the [**Bundletool**](https://developer.a ### Prerequisites -The workflow steps that need to be executed before running the **Bundle Universal Apk** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Bundle Universal Apk** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -31,7 +31,7 @@ If a step other than the **Android Build** or **Android Sign** step is used to b ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Bundle Universal Apk** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -46,7 +46,7 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | --------------------- | -------------------------------- | diff --git a/docs/workflows/android-specific-workflow-steps/detekt.md b/docs/workflows/android-specific-workflow-steps/detekt.md index e3dce2e78..24ff3123a 100644 --- a/docs/workflows/android-specific-workflow-steps/detekt.md +++ b/docs/workflows/android-specific-workflow-steps/detekt.md @@ -14,7 +14,7 @@ The Appcircle Detekt step executes the Detekt Gradle task. For further details, ### Prerequisites -Below are the prerequisite workflow steps required before running the **Detekt** step, along with their reasons: +Before running the **Detekt** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -24,7 +24,7 @@ Below are the prerequisite workflow steps required before running the **Detekt** ### Input Variables -Each component requires specific input variables for its operation. The input variables necessary for the **Detekt** step are: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md index cf3fae5a8..e6f395e24 100644 --- a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md +++ b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md @@ -12,7 +12,7 @@ Appcircle is integrated with the [Firebase Test Lab](https://firebase.google.com ## Prerequisites -The necessary workflow steps to execute before running the **Firebase Test Lab for Android** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Firebase Test Lab for Android** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -61,7 +61,7 @@ If you want to use the UI Test Build output or the Signed Build output in the Fi ## Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Build for UI Testing** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/android-specific-workflow-steps/gradle-runner.md b/docs/workflows/android-specific-workflow-steps/gradle-runner.md index b964f7327..4cbd05adf 100644 --- a/docs/workflows/android-specific-workflow-steps/gradle-runner.md +++ b/docs/workflows/android-specific-workflow-steps/gradle-runner.md @@ -12,7 +12,7 @@ The **Gradle Runner** workflow step executes the specified [Gradle task](https:/ ### Prerequisites -The workflow steps that need to be executed before running the **Gradle Runner** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Gradle Runner** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -22,7 +22,7 @@ The workflow steps that need to be executed before running the **Gradle Runner** ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Gradle Runner** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/android-specific-workflow-steps/lint.md b/docs/workflows/android-specific-workflow-steps/lint.md index f5e18bb43..911f332c8 100644 --- a/docs/workflows/android-specific-workflow-steps/lint.md +++ b/docs/workflows/android-specific-workflow-steps/lint.md @@ -14,7 +14,7 @@ This step is used to run Lint Gradle tasks in your project via Appcircle. ### Prerequisites -The workflow steps that need to be executed before running the **Android Lint** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Android Lint** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -30,7 +30,7 @@ Please ensure that you insert the **Android Lint** step before using the **Andro ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Android Lint** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -53,7 +53,7 @@ If you have filled in the required variables in the **Configuration** section, y ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/android-specific-workflow-steps/post-processor.md b/docs/workflows/android-specific-workflow-steps/post-processor.md deleted file mode 100644 index cd70f1338..000000000 --- a/docs/workflows/android-specific-workflow-steps/post-processor.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Android App Post-Processor -description: This step performs the necessary system operations to identify and process the Android output binary files. -tags: [android, mobile, post processor] ---- - -import Screenshot from '@site/src/components/Screenshot'; - -# Android App Post-Processor -This step performs the necessary system operations to identify and process the Android output binary files. - -:::danger -This step also verifies whether the app is signed or not. If this step is not included in your Workflow or if it is determined that there is no signed app as a result of this step, __the app cannot be distributed__. -::: - -### Prerequisites -The workflow steps that need to be executed before running the **Android App Post-Processor** workflow step, along with their respective reasons, are listed in the table below. - -| Prerequisite Workflow Step | Description | -|-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | To process Android output, these outputs must be obtained from the build step. | -| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-sign) | If a signed app is created, this step needs to be run beforehand to process this output. | - - - -:::caution -If a step other than the **Android Build** or **Android Sign** step is used to build or sign the app, then the **Android App Post-Processor** step depends on this step. -::: - -### Input Variables -There is no need to enter an input for this component. It will process Android files under the output directory (`$AC_OUTPUT_DIR`). - -### Output Variables -The outputs that can result from the operation of this component are listed as follows: - - - -| Variable Name | Description | -|----------------------------------------|---------------------------------------------------| -| `AC_ANDROID_POST_PROCESS_OUTPUT_PATH` | Specifies the application post process file path. This file specifies the base name for each app and whether it is signed or not. | - -:::info -The output post-processing JSON file should adhere to the following structure: -```jsx title="ac_post_process_output.json" -[ - { - "signed": true|false, - "app_name": "app base name" - }, - {...} -] -``` -::: - -:::caution - -To share the signed apps created as a result of this step or to view them on the **Download Artifacts** page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step is included in your Workflow after this step. - -::: - ---- - -To access the source code of this component, please use the following link: - -https://github.com/appcircleio/appcircle-android-build-component.git \ No newline at end of file diff --git a/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md b/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md index 73044748f..d404a3c5b 100644 --- a/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md @@ -21,7 +21,7 @@ For additional details, please refer to the document: [**Generating Test Report* ### Prerequisites -Before executing the **Test Report** workflow step, certain prerequisite workflow steps must be completed: +Before running the **Test Reports for Android** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------ | ----------------------------------------------------------------------------- | @@ -32,7 +32,7 @@ Before executing the **Test Report** workflow step, certain prerequisite workflo ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for **Test Reports** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -45,7 +45,7 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | -------------------------- | ---------------------------------------------------- | diff --git a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md index 2a3ab9c31..5738b89d9 100644 --- a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md +++ b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md @@ -20,7 +20,7 @@ Ensure that you select the **Intel Pool** in the Configuration tab, as the **Wai ### Prerequisites -The workflow steps that need to be executed before running the **Wait for Android Emulator** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Wait for Android Emulator** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -37,7 +37,7 @@ If a step other than the **Android Build** or **Android Sign** step is used to b ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for the **Wait for Android Emulator** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/active-ssh-private-key.md b/docs/workflows/common-workflow-steps/active-ssh-private-key.md index 2b5862172..5e30b07b9 100644 --- a/docs/workflows/common-workflow-steps/active-ssh-private-key.md +++ b/docs/workflows/common-workflow-steps/active-ssh-private-key.md @@ -22,7 +22,7 @@ If you connect to your repository via SSH, use this step before the [**Git Clone ### Input Variables -Below are the parameters required for this step, along with detailed explanations. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -33,7 +33,7 @@ Below are the parameters required for this step, along with detailed explanation ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | diff --git a/docs/workflows/common-workflow-steps/add-badge-app-icon.md b/docs/workflows/common-workflow-steps/add-badge-app-icon.md index 7938e70ad..ff3a4a8a7 100644 --- a/docs/workflows/common-workflow-steps/add-badge-app-icon.md +++ b/docs/workflows/common-workflow-steps/add-badge-app-icon.md @@ -17,7 +17,7 @@ With Appcircle's **Add Badge to Your App Icon** component, you can add badges an ### Prerequisites -Below is a list of workflow steps that need to be executed before this step, along with their respective reasons. +Before running the **Add a Badge to Your App Icon** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -34,7 +34,7 @@ If you are using the [**Increment Build and Version Number**](/versioning/ios-ve ### Input Variables -Below is a list of input variables that can be used with this component with a description of each. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/appium-server.md b/docs/workflows/common-workflow-steps/appium-server.md index a8f67f7e1..4bd3060c6 100644 --- a/docs/workflows/common-workflow-steps/appium-server.md +++ b/docs/workflows/common-workflow-steps/appium-server.md @@ -15,11 +15,7 @@ You can easily integrate the **Appium CLI** into your pipeline using Appcircle's ### Prerequisites -:::info - -This step does not require any specific components to function. You can place it anywhere within your pipeline according to your workflow needs. - -::: +There are no prerequisites required before using the **Appium Server** step. You can place it anywhere within your pipeline according to your workflow needs. ### Input Variables diff --git a/docs/workflows/common-workflow-steps/authenticate-with-netrc.md b/docs/workflows/common-workflow-steps/authenticate-with-netrc.md index 8aa11e3b1..7b23c3219 100644 --- a/docs/workflows/common-workflow-steps/authenticate-with-netrc.md +++ b/docs/workflows/common-workflow-steps/authenticate-with-netrc.md @@ -12,7 +12,7 @@ The `.netrc` file contains login and initialization information used by the auto ### Prerequisites -There is no mandatory step before the **Authenticate with Netrc** step. +There are no prerequisites required before using the **Authenticate with Netrc** step. :::danger @@ -24,7 +24,7 @@ Please note that you should use this step before your **Git Clone** step. If you ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md index e36d82883..7a2333428 100644 --- a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md +++ b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md @@ -18,7 +18,7 @@ The full details of the tests are accessible in the [AWS Device Farm console](ht ### Prerequisites -This component works separately for iOS and Android. It depends on different steps for both platforms. +Before running the **AWS Device Farm and Deploy** step, you must complete certain prerequisites, as detailed in the table below: :::caution @@ -41,7 +41,7 @@ Pay attention to the dependent step on whichever platform you are working on. ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/azure-board.md b/docs/workflows/common-workflow-steps/azure-board.md index e2d4d0dad..c27797c05 100644 --- a/docs/workflows/common-workflow-steps/azure-board.md +++ b/docs/workflows/common-workflow-steps/azure-board.md @@ -16,7 +16,7 @@ You can use the [Azure Boards Component](https://github.com/appcircleio/appcircl ### Prerequisites -There is no mandatory sequence for the use of this component. It depends on your business decision which step to use before or after in your workflow. +There are no prerequisites required before using the **Azure Boards** step. It depends on your business decision which step to use before or after in your workflow. :::caution @@ -43,7 +43,7 @@ open(env_var_path, 'a') { |f| ### Input Variables -There are some necessary parameters for this stepper to work properly. These parameters are given in the table below with their explanations. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md index 233e825fe..2b1402d18 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md @@ -28,6 +28,8 @@ These variables can be adjusted within the [cache label](#input-variables) field ### Prerequisites +There are no prerequisites required before using the **Cache Pull** step. + :::caution This component does not require any prerequisite steps for operation. The only thing necessary for the component to work as expected is to utilize the cached files before the step in which they will be used. Additionally, an important prerequisite for this step to function properly is that the files to be used must have been cached in previous builds. @@ -46,7 +48,7 @@ If there are no previously cached files and you attempt to use this step, the ** ### Input Variables -The parameters required for the operation of this step are given in the list below with their descriptions. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-push.md b/docs/workflows/common-workflow-steps/build-cache/cache-push.md index fe666159f..257ae33c6 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-push.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-push.md @@ -34,7 +34,7 @@ The system automatically cleans unreachable and obsolete cache files periodicall ### Prerequisites -Before running the **Cache Push** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **Cache Push** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -57,7 +57,7 @@ The other important prerequisite for this component to work is that it must be u ### Input Variables -The parameters required for the operation of this step are given in the list below with their descriptions. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/custom-script.md b/docs/workflows/common-workflow-steps/custom-script.md index e55b9cc5a..1d29a0be9 100644 --- a/docs/workflows/common-workflow-steps/custom-script.md +++ b/docs/workflows/common-workflow-steps/custom-script.md @@ -12,6 +12,10 @@ import Screenshot from '@site/src/components/Screenshot'; You can use **Custom Script** steps for additional functionalities in your builds. Appcircle will run the commands in your custom scripts and perform the specified actions. These scripts will be run on the runner and you can use any functionality of the build environment as you need. +### Prerequisites + +There are no prerequisites required before using the **Custom Script** step. + :::tip Note that you can put the **Custom Script** component anywhere you want in the workflow. This step is used to add different capabilities to the existing workflow. @@ -22,7 +26,7 @@ Note that you can put the **Custom Script** component anywhere you want in the w ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/danger.md b/docs/workflows/common-workflow-steps/danger.md index c8c968155..a59f0bfb7 100644 --- a/docs/workflows/common-workflow-steps/danger.md +++ b/docs/workflows/common-workflow-steps/danger.md @@ -25,7 +25,7 @@ This tool does not support AzureDevOps. Therefore, if your repository is hosted ### Prerequisites -The workflow steps that need to be executed before running the **Danger** step vary depending on the platform and are listed below: +Before running the **Danger** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -41,7 +41,7 @@ Note that this component synchronizes with the [**Appcircle Triggers**](/build/b ### Input Variables -Below is a list of input variables that can be used with this component with a description of each. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md b/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md index c30f74f87..5cbc29c33 100644 --- a/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md +++ b/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md @@ -12,7 +12,7 @@ The **Data Theorem Mobile Secure** step integrates the [Data Theorem Mobile Secu ### Prerequisites -The workflow steps that need to be executed before running the **Data Theorem Mobile Secure** step vary depending on the platform and are listed below: +Before running the **Data Theorem Mobile Secure** step, you must complete certain prerequisites, as detailed in the table below: #### For Android (Java / Kotlin and React Native) @@ -51,7 +51,7 @@ The workflow steps that need to be executed before running the **Data Theorem Mo ### Input Variables -Specific input variables are required for the operation of each component in your system. The following are the input variables necessary for the **Data Theorem Mobile Secure** step: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/export-build-artifacts.md b/docs/workflows/common-workflow-steps/export-build-artifacts.md index 7a8a2f3c8..061e28bd8 100644 --- a/docs/workflows/common-workflow-steps/export-build-artifacts.md +++ b/docs/workflows/common-workflow-steps/export-build-artifacts.md @@ -19,9 +19,11 @@ Sending applications to **Publish**, **Enterprise App Store**, or **Testing Dist ### Prerequisites -:::info +There are no prerequisites required before using the **Export Build Artifact** step. -We recommend using it as the last step in your workflow. +:::note + +We **recommend** using it as the **last** step in your workflow. ::: @@ -49,7 +51,7 @@ If you use the **Default Workflow** templates, the option "**Always run this ste ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/fastlane.md b/docs/workflows/common-workflow-steps/fastlane.md index e4b06a340..012072d3b 100644 --- a/docs/workflows/common-workflow-steps/fastlane.md +++ b/docs/workflows/common-workflow-steps/fastlane.md @@ -14,7 +14,7 @@ With Appcircle, you can automate your build and signing processes with the flexi ### Prerequisites -The workflow steps that need to be executed before running the Fastlane workflow step, along with their respective reasons, are listed in the table below. +Before running the **Fastlane** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -31,7 +31,7 @@ Fastlane needs project files to work. If there is no **Git Clone** step in your ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/file-size-check.md b/docs/workflows/common-workflow-steps/file-size-check.md index 60c0bf859..d1be8d13a 100644 --- a/docs/workflows/common-workflow-steps/file-size-check.md +++ b/docs/workflows/common-workflow-steps/file-size-check.md @@ -32,6 +32,11 @@ If you use a different build step than the ones mentioned above to generate the ### Input Variables + +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). + +:::note + When you enter this component detail, you need to specify the **File Size** and **Check Action**. The file size parameter here represents the **maximum allowable** size of the **IPA**, **APK** or **AAB** file. If the archived application size exceeds this size, the pipeline will be **broken** or **warned** according to the **fail** or **warn** option you specify in the check action parameter. @@ -40,7 +45,7 @@ If you select **warn**, this is how it will appear in your build list: -You can find all the parameters required for this step in the table below, with their descriptions in detail. +::: | Variable Name | Description | Status | |----------------------------------|------------------------------------------------|--------------------------| diff --git a/docs/workflows/common-workflow-steps/firebase-app-distribution.md b/docs/workflows/common-workflow-steps/firebase-app-distribution.md index b5568669e..636bde6be 100644 --- a/docs/workflows/common-workflow-steps/firebase-app-distribution.md +++ b/docs/workflows/common-workflow-steps/firebase-app-distribution.md @@ -25,7 +25,7 @@ For more details, please refer to the following links: ### Prerequisites -Below are the workflow steps required before running the **Firebase App Distribution** step, listed with their reasons. Prerequisites vary by platform: +Before running the **Firebase App Distribution** step, you must complete certain prerequisites, as detailed in the table below: #### For Android (Java / Kotlin and React Native) @@ -64,7 +64,7 @@ Below are the workflow steps required before running the **Firebase App Distribu ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for **Firebase App Distribution** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md index ebe3a1249..85f816efc 100644 --- a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md +++ b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md @@ -54,7 +54,7 @@ Before running the **Fortify on Demand Mobile Assessment** step, you must comple ### Input Variables -Below is a list of input variables that can be used with this component, along with a description of each. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -80,7 +80,6 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v --- - To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-fod-mobile-assessment \ No newline at end of file diff --git a/docs/workflows/common-workflow-steps/ftp-upload.md b/docs/workflows/common-workflow-steps/ftp-upload.md index c97581184..2b2fbaf24 100644 --- a/docs/workflows/common-workflow-steps/ftp-upload.md +++ b/docs/workflows/common-workflow-steps/ftp-upload.md @@ -13,7 +13,9 @@ Appcircle's FTP Upload (File Transfer Protocol) integration lets you easily uplo ### Prerequisites -:::info +There are no prerequisites required before using the **FTP Upload** step. + +:::caution This step has no prerequisites but must follow the artifact production step. For example, as the screenshot below demonstrates, use it right after the [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) step. This setup ensures the IPA file produced in the pipeline is sent to any **FTP server**. @@ -31,7 +33,7 @@ Note that to send a file to an **FTP server**, the file must be generated within ### Input Variables -Below is a list of input variables that can be used with this component, with a description of each. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/git-clone.md b/docs/workflows/common-workflow-steps/git-clone.md index e8314b411..d4ac8d0e7 100644 --- a/docs/workflows/common-workflow-steps/git-clone.md +++ b/docs/workflows/common-workflow-steps/git-clone.md @@ -12,7 +12,7 @@ The **Git Clone** step is used to fetch the source code repository from a Git pr ### Prerequisites -Below is a list of workflow steps that must be completed before executing the **Git Clone** workflow step, along with their respective descriptions: +Before running the **Git Clone** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -34,7 +34,7 @@ We recommend using this step at the beginning of the workflow to avoid any probl ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -57,6 +57,8 @@ After connecting the repository, the following [**Reserved Environment Variables ### Output Variables +The output(s) resulting from the operation of this component are as follows: + | Variable Name | Description | |-------------------------------|------------------------------------------------| | `AC_REPOSITORY_DIR` | Specifies the root directory of the cloned repository. This path is automatically generated after the repository is cloned. | diff --git a/docs/workflows/common-workflow-steps/jira-comment.md b/docs/workflows/common-workflow-steps/jira-comment.md index b5b5728dc..3863d6ef2 100644 --- a/docs/workflows/common-workflow-steps/jira-comment.md +++ b/docs/workflows/common-workflow-steps/jira-comment.md @@ -16,7 +16,7 @@ By adding Appcircle's [**Jira Comment**](https://github.com/appcircleio/appcircl ## Prerequisites -There is no mandatory sequence for the use of this component. It depends on your business decision which step to use before or after in your workflow. +There are no prerequisites required before using the **Jira Comment** step. :::caution @@ -66,7 +66,7 @@ If you're utilizing [API version 2](https://developer.atlassian.com/cloud/jira/p ## Input Variables -There are some necessary parameters for this stepper to work properly. These parameters are given in the table below with their descriptions. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md index 9fe27ef34..65f159a62 100644 --- a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md +++ b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md @@ -14,7 +14,7 @@ The Appcircle **Maestro Cloud Upload** step enables users to upload their mobile ## Prerequisites -Before running the **Maestro Cloud Upload** step, certain prerequisites must be completed. These prerequisites, detailed in the table below, vary depending on the platform: +Before running the **Maestro Cloud Upload** step, you must complete certain prerequisites, as detailed in the table below: ### For All Platforms @@ -59,7 +59,7 @@ Before running the **Maestro Cloud Upload** step, certain prerequisites must be ## Input Variables -The **Maestro Cloud Upload** step requires specific input variables: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/marathon-cloud.md b/docs/workflows/common-workflow-steps/marathon-cloud.md index 8c6de6f5c..3c3f55b5e 100644 --- a/docs/workflows/common-workflow-steps/marathon-cloud.md +++ b/docs/workflows/common-workflow-steps/marathon-cloud.md @@ -15,10 +15,12 @@ The **Marathon Cloud** component is an integrated test automation workflow step ### Prerequisites -This component needs some prerequisites for proper operation; the necessary steps are given in the table below with details. +Before running the **Marathon Cloud** step, you must complete certain prerequisites, as detailed in the table below: :::caution + Please note that this component works separately on both the native **Android** and **iOS** platforms. The requirements for both platforms are different. + ::: | Prerequisite Workflow Step | Description | @@ -43,7 +45,7 @@ Please note that if you do not change this parameter, the Marathon Cloud compone ### Input Variables -The parameters required for the operation of this component are given below with explanations.  +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/publish-release-notes.md b/docs/workflows/common-workflow-steps/publish-release-notes.md index f2e21927e..f1d786c7a 100644 --- a/docs/workflows/common-workflow-steps/publish-release-notes.md +++ b/docs/workflows/common-workflow-steps/publish-release-notes.md @@ -34,7 +34,7 @@ To create rich release notes, the Release Notes component should be included in ### Input Variables -You can find all the parameters required for this step in the table below, along with detailed descriptions. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/repeato-test-runner.md b/docs/workflows/common-workflow-steps/repeato-test-runner.md index 5897fbc04..1c77e3cc3 100644 --- a/docs/workflows/common-workflow-steps/repeato-test-runner.md +++ b/docs/workflows/common-workflow-steps/repeato-test-runner.md @@ -18,7 +18,7 @@ https://appcircle.io/blog/streamline-project-integration-and-test-automation-wit ### Prerequisites -Before executing the **Repeato Test Runner** workflow step, certain prerequisite workflow steps must be completed: +Before running the **Repeato Test Runner** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -54,7 +54,7 @@ Confidential information must be entered as a [secret environment variable](/env ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | -------------------------- | -------------------------------------------------------- | diff --git a/docs/workflows/common-workflow-steps/set-environment-variable.md b/docs/workflows/common-workflow-steps/set-environment-variable.md index 74cd3a519..d67e6aa07 100644 --- a/docs/workflows/common-workflow-steps/set-environment-variable.md +++ b/docs/workflows/common-workflow-steps/set-environment-variable.md @@ -11,7 +11,7 @@ import Screenshot from '@site/src/components/Screenshot'; The **Set Environment Variable** step enables the setting of environment values for specified keys. Although creating environment variables via the [Environment Variables](/environment-variables/) page is typically recommended, this step provides flexibility to modify environment variables directly within the build workflow when necessary. ### Prerequisites -There is no prerequisites step before the **Set Environment Variable** step. It can be implemented at any point within the workflow as necessary. +There are no prerequisites required before using the **Set Environment Variable** step. It can be implemented at any point within the workflow as necessary. :::danger @@ -23,7 +23,8 @@ Please note that you must use the **Set Environment Variable** step before the s ### Input Variables -Each component requires specific input variables for operation. For the **Set Environment Variable** step, the necessary input variables are: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). + :::danger @@ -37,10 +38,6 @@ Confidential information should be entered as a [secret environment variable](/e | `$AC_SETENV_KEYS` | Specifies the key of the environment variable to be set. This should be a space-separated list of environment variable keys. | Required | | `$AC_SETENV_VALUE` | Specifies the value of the environment variable to set. If this field is left blank, the environment variable will be set to `null`. | Optional | -### Output Variables - -The **Set Environment Variable** step generates no output variables. Success or failure of this step depends on whether the environment variable is set correctly, allowing subsequent use within the workflow. - --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/snyk-scan-security.md b/docs/workflows/common-workflow-steps/snyk-scan-security.md index 30a7d4722..66e9f461c 100644 --- a/docs/workflows/common-workflow-steps/snyk-scan-security.md +++ b/docs/workflows/common-workflow-steps/snyk-scan-security.md @@ -14,7 +14,7 @@ The **Snyk Security Scan** step integrates directly into Appcircle’s CI/CD wor ### Prerequisites -Before running the **Snyk Scan Security** step, certain prerequisites must be completed. These prerequisites, detailed in the table below: +Before running the **Snyk Scan Security** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | -------------------------- | --------------------------------------------------------------------------------------------- | @@ -24,7 +24,7 @@ Before running the **Snyk Scan Security** step, certain prerequisites must be co ### Input Variables -Each component requires specific input variables for its operation. The input variables necessary for the **Snyk Scan Security** step are: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -49,7 +49,7 @@ Enter confidential information as a [secret environment variable](/environment-v ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Output Variable | Description | |--------------------------------|--------------------------------------------------------------------------------------------------------------------------| diff --git a/docs/workflows/common-workflow-steps/sonarqube.md b/docs/workflows/common-workflow-steps/sonarqube.md index e56367924..f3657594c 100644 --- a/docs/workflows/common-workflow-steps/sonarqube.md +++ b/docs/workflows/common-workflow-steps/sonarqube.md @@ -14,14 +14,15 @@ This step allows you to analyse your code quality with the [SonarQube CLI](https ### Prerequisites -The workflow steps that need to be executed before running the **SonarQube** workflow step, along with their respective reasons, are listed in the table below. +Before running the **SonarQube** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | If you intend to retrieve the **SonarQube Scanner** parameters from the `sonar-project.properties` file in your repository, it's essential to employ the **Git Clone** step before the **SonarQube** step. After the **Git Clone** step is completed, it generates the `AC_REPOSITORY_DIR` variable, which is used as input for the **SonarQube** step. | ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. + +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/common-workflow-steps/testinium.md b/docs/workflows/common-workflow-steps/testinium.md index bf0d69917..71cd4b7a4 100644 --- a/docs/workflows/common-workflow-steps/testinium.md +++ b/docs/workflows/common-workflow-steps/testinium.md @@ -12,7 +12,7 @@ The **Testinium** step integrates the [Testinium](https://testinium.com/) testin ### Prerequisites -Before running the **Testinium** step, certain prerequisites must be completed. These prerequisites, detailed in the table below, vary depending on the platform: +Before running the **Testinium** step, you must complete certain prerequisites, as detailed in the table below: #### For Android (Java / Kotlin and React Native) @@ -51,7 +51,7 @@ Before running the **Testinium** step, certain prerequisites must be completed. ### Input Variables -For each component, specific input variables are required for its operation on your system. The input variables necessary for **Testinium** are as follows: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -75,7 +75,7 @@ Confidential information should be entered as a [secret environment variable](/e ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md b/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md index 16eb71083..a96037d27 100644 --- a/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md +++ b/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md @@ -16,15 +16,19 @@ The **Upload Files to Amazon S3** step in Appcircle enables direct uploading of There are no prerequisites required before using the **Upload Files to Amazon S3** step. +:::info + To begin, add the **Upload Files to Amazon S3** step to the workflow from the [workflow marketplace](/workflows/#workflow-marketplace). You can incorporate it at any point within the workflow and multiple times, as necessary, to upload specific files or folders. For example, you can place it after the build step to deploy the build outputs. Once added, exit the workflow edit mode by saving your changes, and then click on the **Upload Files to Amazon S3** step. +::: + ### Input Variables -Below is a table containing all the parameters required for the **Upload Files to Amazon S3** step, along with detailed descriptions: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -45,7 +49,7 @@ It is highly recommended to add the keys as [secret environment variables](../.. ### Output Variables -As the output may vary depending on the task you execute, there is no specific output defined by default. +The output(s) resulting from the operation of this component are as follows: | Output Variable | Description | |-------------------------|----------------------------------------------------------------| diff --git a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md index 44546ee1b..f0bb695a3 100644 --- a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md +++ b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md @@ -14,7 +14,7 @@ Deploy web applications effortlessly using Appcircle's Firebase Deployment compo ### Prerequisites -Before running the **Firebase Deployment** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **Firebase Deployment** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -25,7 +25,7 @@ Before running the **Firebase Deployment** step, certain prerequisites must be c ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md index cc2edda37..4fc704929 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md @@ -12,7 +12,7 @@ This component runs the `flutter analyze` command in your Flutter project. Pleas ### Prerequisites -Before running the **Flutter Analyze** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **Flutter Analyze** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -27,7 +27,7 @@ This step is particularly dependent on the Flutter Install step. If the Flutter ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md index 255814ea1..2af16b90a 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md @@ -12,7 +12,7 @@ The **Flutter Build for Android** step automates the generation of Android APK ( ### Prerequisites -Before running the **Flutter Build for Android** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **Flutter Build for Android** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | -------------------------- | --------------------------------------------------------------------------------------------- | @@ -22,7 +22,7 @@ Before running the **Flutter Build for Android** step, certain prerequisites mus ### Input Variables -Each component requires specific input variables for its operation. The input variables necessary for the **Flutter Build for Android** step are: +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -43,7 +43,7 @@ If the required variables are already defined in the **Configuration** section, ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Output Variable | Description | |---------------------------|---------------------------------| diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md index d139c4b70..70a3dedd1 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md @@ -12,7 +12,7 @@ This step makes your Flutter project suitable for the iOS environment and builds ### Prerequisites -Before running the **Flutter Build for iOS** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **Flutter Build for iOS** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -26,12 +26,14 @@ Once you have compiled your app for Flutter iOS, the native environment will be :::danger + **Keep in mind** that this step is dependent on the Flutter Install step. If Flutter is not installed on the system, it will give a Flutter SDK not found error. + ::: ### Input Variables -The parameters required for this step to work are given in the table below with explanations. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md index 280b680db..78335750f 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md @@ -12,7 +12,7 @@ The **Flutter Build for Web** step builds your web application using the [Flutte ### Prerequisites -Before running the **​Flutter Build for Web** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **​Flutter Build for Web** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -29,7 +29,7 @@ This step relies heavily on the **Flutter Install** step. If the Flutter SDK is ### Input Variables -You can find all the parameters required for this step in the table below, along with detailed descriptions. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -40,7 +40,7 @@ You can find all the parameters required for this step in the table below, along ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |------------------------|-------------------------------------| diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md index 92b2491bc..f76d52f4b 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md @@ -11,7 +11,9 @@ import Screenshot from '@site/src/components/Screenshot'; This workflow step installs the specified [**Flutter SDK**](https://docs.flutter.dev/get-started/install) to run the [**Flutter CLI**](https://docs.flutter.dev/reference/flutter-cli) for subsequent analysis, build, and test operations. The Flutter version can be specified in [Configuration](https://docs.appcircle.io/build/building-flutter-applications/#build-configuration-for-flutter-applications). :::info + All Flutter versions and detailed information can be found in the [Flutter repository](https://github.com/flutter/flutter). + ::: ### Prerequisites @@ -40,7 +42,7 @@ The steps specified in the table are steps dependent on the **Flutter Install** ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -56,7 +58,7 @@ If no specific version is specified, this step will automatically install the la ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md index 7e00281be..853fd45d4 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md @@ -12,7 +12,7 @@ This component allows you to run [**Flutter Unit Tests**](https://docs.flutter.d ### Prerequisites -Before running the **Flutter Test** step, certain prerequisites must be completed. These prerequisites are detailed in the table below: +Before running the **Flutter Test** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -41,7 +41,7 @@ You can find all the parameters required for this step in the table below, with ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| diff --git a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md index 145dd8afa..47a07a430 100644 --- a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md +++ b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md @@ -12,7 +12,7 @@ With this step, you can send your `IPA` and `dSYM` files to the [App Center](htt ### Prerequisites -- First, you need to use this step after the **Xcodebuild for Devices.** This is because the project is compiled and archived in the Xcodebuild for Devices step. +Before running the **App Center iOS Distrubiton** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -28,7 +28,7 @@ Note that if you do not use this step after the [**Xcodebuild for Devices**](htt ### Input Variables -- Inside the step, there will be some parameters that you need to configure according to your **App Center account**. You can find the list and detailed descriptions of all parameters of the step in the table below. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index abe2a68bc..b659eefd9 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -16,7 +16,7 @@ https://appcircle.io/blog/elevate-your-mobile-app-security-with-appdome-integrat ### Prerequisites -The workflow steps that need to be executed before running the **Appdome Build-2Secure for iOS** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Appdome Build-2Secure for iOS** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | @@ -32,7 +32,7 @@ If a step other than the **Xcodebuild for Devices** step is used to build or sig ### Input Variables -This stepper needs the necessary parameters to operate. You can find all parameters and their detailed descriptions in the table below. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -58,7 +58,7 @@ We recommend using [Environment Variables](/environment-variables/) groups for s ### Output Variables -The outputs that can result from the operation of this component are listed as follows: +The output(s) resulting from the operation of this component are as follows: :::caution diff --git a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md index 383abc47d..9483f63e6 100644 --- a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md +++ b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md @@ -32,7 +32,7 @@ The **Audit Permission Changes** component will automatically break the pipeline ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md index 7a146c13c..310ca77d0 100644 --- a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md @@ -30,7 +30,7 @@ For this component to work, a PR must be opened, and a trigger must be set up ba ### Prerequisites -The workflow steps that need to be executed before running the **Swiftlint** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Azure Bot for Swiftlint** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -40,7 +40,7 @@ The workflow steps that need to be executed before running the **Swiftlint** wor ### Input Variables -This component needs some parameters to operate. You can find the required parameters and their detailed descriptions in the list below. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md index e5456cba2..e6da00e30 100644 --- a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md +++ b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md @@ -29,7 +29,7 @@ In the build step, if there is no **Xcodebuild Build for Testing** step before * ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/ios-specific-workflow-steps/carthage.md b/docs/workflows/ios-specific-workflow-steps/carthage.md index a9d631294..cebb4a84e 100644 --- a/docs/workflows/ios-specific-workflow-steps/carthage.md +++ b/docs/workflows/ios-specific-workflow-steps/carthage.md @@ -14,7 +14,8 @@ import Screenshot from '@site/src/components/Screenshot'; ### Prerequisites -Appcircle will look for a [`Cartfile`](https://github.com/Carthage/Carthage/blob/master/Documentation/Artifacts.md) file in your repository and use it to install the dependencies. For this reason, **it should be used after the Git Clone step**. +Before running the **Carthage** step, you must complete certain prerequisites, as detailed in the table below: + | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -22,9 +23,15 @@ Appcircle will look for a [`Cartfile`](https://github.com/Carthage/Carthage/blob +:::caution + +Appcircle will look for a [`Cartfile`](https://github.com/Carthage/Carthage/blob/master/Documentation/Artifacts.md) file in your repository and use it to install the dependencies. For this reason, **it should be used after the Git Clone step**. + +::: + ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md index 4d8aa27d3..614031d0a 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md @@ -30,7 +30,7 @@ Please remember to use the [**CocoaPods Install**](/workflows/ios-specific-workf ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md index 12920ff5a..a77600c41 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md @@ -12,7 +12,7 @@ Runs the [CocoaPods](https://cocoapods.org) install command for dependency manag ### Prerequisites -The workflow steps that need to be executed before running the **Cocoapods Install** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Cocoapods Install** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -22,7 +22,7 @@ The workflow steps that need to be executed before running the **Cocoapods Insta ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md index 8fd076d1e..23131c078 100644 --- a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md +++ b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md @@ -29,7 +29,7 @@ Please note that if you do not run **Xcodebuild for Unit and UI Tests** before t ### Input Variables -The parameters required for the operation of this stepper are given below with explanations. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -44,7 +44,7 @@ The parameters required for the operation of this stepper are given below with e ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|-------------------------------------| diff --git a/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md b/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md index b4be0d4ab..43b083b35 100644 --- a/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md +++ b/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md @@ -12,7 +12,7 @@ This step allows to upload your debug symbols to [**Firebase Crashlytics**](http ### Prerequisites -The workflow steps that need to be executed before running the **Firebase Upload dSYM** workflow step, along with their respective reasons, are listed in the table below. +Before running the **Firebase Upload dSYM** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -28,7 +28,7 @@ If this step is not used after **Xcodebuild for Devices**, the pipeline will giv ### Input Variables -You can find all the parameters required for this step in the table below with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md index 060d00f9d..08f211792 100644 --- a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md +++ b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md @@ -36,7 +36,7 @@ Please remember. If you are using **manual sign**, you should definitely use thi ### Input Variables -The parameters required for this step to work are listed in the table below. These parameters are defaults. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -49,7 +49,7 @@ The parameters required for this step to work are listed in the table below. The ### Output Variables -The output parameters after this step is executed are as follows: +The output(s) resulting from the operation of this component are as follows: diff --git a/docs/workflows/ios-specific-workflow-steps/slather.md b/docs/workflows/ios-specific-workflow-steps/slather.md index bbb9623da..1ed727d84 100644 --- a/docs/workflows/ios-specific-workflow-steps/slather.md +++ b/docs/workflows/ios-specific-workflow-steps/slather.md @@ -30,7 +30,7 @@ Before running the **Slather** step, you must complete certain prerequisites, as ## Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/swiftlint.md b/docs/workflows/ios-specific-workflow-steps/swiftlint.md index 2e93552a7..70c1b3b3a 100644 --- a/docs/workflows/ios-specific-workflow-steps/swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/swiftlint.md @@ -11,7 +11,7 @@ SwiftLint checks the source code for programmatic as well as stylistic errors. T ### Prerequisites -Remember, SwiftLint must be used after the following steps in order to work as expected. +Before running the **SwiftLint** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -36,7 +36,7 @@ If you have SPM in your project and you are using the SwiftLint component in you ### Input Variables -You can also customize your SwiftLint step with the options in the component. You can find all the detailed descriptions for all variables in the table below. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -52,7 +52,7 @@ You can also customize your SwiftLint step with the options in the component. Yo ### Output Variables -The output parameters after this step is executed are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| diff --git a/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md b/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md index 69fd7d81b..a5219a762 100644 --- a/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/test-reports-for-ios.md @@ -22,7 +22,7 @@ For additional details, please refer to the document: [**Generating Test Report* ### Prerequisites -Before executing the **Test Report** workflow step, certain prerequisite workflow steps must be completed: +Before running the **Test Reports for iOS** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ------------------------------------------------------------ | ----------------------------------------------------------------------------- | @@ -31,7 +31,7 @@ Before executing the **Test Report** workflow step, certain prerequisite workflo ### Input Variables -For each component, specific input variables are required for its operation on your system. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). | Variable Name | Description | Status | | ------------------------ | ---------------------------------------------------------------- | --------- | @@ -41,7 +41,7 @@ For each component, specific input variables are required for its operation on y ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | -------------------------- | ---------------------------------------------------- | diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md index 4b1c13c48..6dccb5675 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md @@ -14,7 +14,7 @@ You can seamlessly integrate Tuist Commands into your workflow with Appcircle, m ### Prerequisites -Before you run the **Tuist Commands** step, you must complete certain prerequisites, as detailed in the table below: +Before running the **Tuist Commands** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |---------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -35,7 +35,7 @@ For more information about Tuist CLI Commands, please visit the [**Tuist CLI**]( ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-install.md b/docs/workflows/ios-specific-workflow-steps/tuist-install.md index 0d5722c90..eba5dc6d4 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-install.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-install.md @@ -20,7 +20,7 @@ Tuist CLI tool is a tool that enables different actions to be performed in the p ### Prerequisites -Before you run the **Tuist Install** step, you must complete certain prerequisites, as detailed in the table below: +Before running the **Tuist Install** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -50,7 +50,7 @@ In Tuist integrated projects, there will be cases where `.xcworkspace` and `.xco ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/ios-specific-workflow-steps/xcode-select.md b/docs/workflows/ios-specific-workflow-steps/xcode-select.md index 742068042..cbd618674 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcode-select.md +++ b/docs/workflows/ios-specific-workflow-steps/xcode-select.md @@ -12,12 +12,18 @@ This step is used to specify the Xcode version to be used during the build proce ### Prerequisites +There are no prerequisites required before using the **Xcode Select** step. + :::danger + Always use this step **before** [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#cocoapods-install) and [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-devices-archive--export). If you have other **Xcode related** steps, such as [**Xcodebuild for iOS Simulators**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-ios-simulator) and [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-unit-and-ui-tests), **don't forget** to use before them. + ::: :::caution + Please **don't forget** to select the **Xcode version** from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration) first. + ::: @@ -49,7 +55,7 @@ You can review the documentation for detailed information about the Xcode versio ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). | Variable Name | Description | Status | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md index f58a5cf67..c262ed6f3 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md @@ -18,7 +18,7 @@ This step is the archive and export step. When the step is completed, the `.ipa` ### Prerequisites -The workflow steps that need to be executed before running this step, along with their respective reasons, are listed in the table below. +Before running the **Xcodebuild for Devices** step, you must complete certain prerequisites, as detailed in the table below: | Require Workflow Step | Description | | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -35,7 +35,7 @@ This step should always follow steps that may affect Archive and Export, such as ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -61,7 +61,7 @@ You can find all the parameters required for this step in the table below, with ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | --------------------------- | --------------------------------------------------------- | diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md index 62392c28e..1b88ae0d2 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md @@ -12,7 +12,7 @@ This step builds your application for the iOS Simulator in x86_64 or arm64 archi ### Prerequisites -Use this step after the **Xcode Select** and **CocoaPods Install** (if you use **CocoaPods** in your project) steps. +Before running the **Xcodebuild for iOS Simulator** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -29,7 +29,7 @@ If you use SPM (Swift Package Manager), Xcode will manage itself when a project ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -52,7 +52,7 @@ Be aware of which OS version you used; the simulator type should match that OS v ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md index 0bf44f401..54033373f 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md @@ -12,7 +12,7 @@ This step builds your application and generates an IPA for testing so that it ca ### Prerequisites -In order for this step to work correctly, it must be used after the two steps listed below. +Before running the **Xcodebuild for Testing** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -29,7 +29,7 @@ If you use SPM (Swift Package Manager), Xcode will manage itself when a project ### Input Variables -You can find the parameters required for this step to work and detailed explanations in the list below. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -45,7 +45,7 @@ You can find the parameters required for this step to work and detailed explanat ### Output Variables -This component outputs some important parameters after running. +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md index 537bef4a2..4b3c9fdee 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md @@ -18,7 +18,7 @@ This step does not generate **IPA**, it only runs tests within the project. ### Prerequisites -Before you run the **Xcodebuild for Unit and UI Testing** step, you must complete certain prerequisites, as detailed in the table below: +Before running the **Xcodebuild for Unit and UI Testing** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------------------------------------------------|-------------------------------------------------| @@ -38,7 +38,7 @@ If any tests fail during this step, an error will be automatically reported, whi ### Input Variables -Below are the parameters required for this step, along with detailed explanations. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -68,6 +68,15 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w ::: ### Output Variables + +The output(s) resulting from the operation of this component are as follows: + | Variable Name | Description | |-------------------------------|----------------------------------------------------------------------------------------------------------| -| `AC_TEST_RESULT_PATH` | The output path for the `.xcresult` file. This environment variable can be utilized in subsequent steps. | \ No newline at end of file +| `AC_TEST_RESULT_PATH` | The output path for the `.xcresult` file. This environment variable can be utilized in subsequent steps. | + +--- + +To access the source code of this component, please use the following link: + +https://github.com/appcircleio/appcircle-ios-test-component \ No newline at end of file diff --git a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md index 1eee301cb..a82adfe64 100644 --- a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md +++ b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md @@ -24,7 +24,7 @@ Before running the **App Center CodePush** step, you must complete certain prere ### Input Variables -Below is a list of input variables that can be used with this component with a description of each. +This step contains some variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/react-native-specific-workflow-steps/node-install.md b/docs/workflows/react-native-specific-workflow-steps/node-install.md index 4e9f54377..da30f2c1a 100644 --- a/docs/workflows/react-native-specific-workflow-steps/node-install.md +++ b/docs/workflows/react-native-specific-workflow-steps/node-install.md @@ -28,7 +28,7 @@ Please note that this step should be used before steps that need the **npm/yarn ### Input Variables -You can find all the parameters required for this step in the table below, with their descriptions in detail. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md index 5635c612d..a3c11f11b 100644 --- a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md +++ b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md @@ -12,7 +12,7 @@ You may want to use the [NPM](https://www.npmjs.com/) or [Yarn](https://www.npmj ### Prerequisites -The workflow steps that need to be executed before running the **NPM/Yarn Commands** workflow step, along with their respective reasons, are listed in the table below. +Before running the **NPM/Yarn Commands** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| @@ -22,7 +22,7 @@ The workflow steps that need to be executed before running the **NPM/Yarn Comman ### Input Variables -This step contains different variables. It needs these variables to work. The table below gives explanations of these variables. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md index f1fb59936..bec0d5d4a 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md @@ -22,7 +22,7 @@ The default Java version in Appcircle's build stacks is **Java 11**. If your pro ### Prerequisites -The workflow steps that need to be executed before running the **React Native UI Test** workflow step in both iOS and Android platforms, along with their respective reasons, are listed in the table below. +Before running the **React Native UI Test** step, you must complete certain prerequisites, as detailed in the table below: #### For iOS @@ -77,7 +77,7 @@ If any workflow steps fail, Appcircle automatically skips the next steps. Howeve ### Input Variables -This step contains different variables. It needs these variables to work. The table below gives explanations of these variables. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md index 179d68ec7..e11943d96 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md @@ -14,7 +14,7 @@ For detailed information for continuous testing, please visit our [React Native ### Prerequisites -The workflow steps that need to be executed before running the **React Native Unit Test** workflow step, along with their respective reasons, are listed in the table below. +Before running the **React Native Unit Test** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | |--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -36,7 +36,7 @@ If any workflow steps fail, Appcircle automatically skips the next steps. Howeve ### Input Variables -This step contains different variables. It needs these variables to work. The table below gives explanations of these variables. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). @@ -54,7 +54,7 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w ### Output Variables -The outputs resulting from the operation of this component are as follows: +The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-----------------------|-----------------------------------------------------------------------------------------------------------------| diff --git a/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md b/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md index 1466c492b..43809e970 100644 --- a/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md +++ b/docs/workflows/react-native-specific-workflow-steps/test-reports-react-native.md @@ -18,7 +18,7 @@ For additional details, please refer to the document: [**Generating Test Report* ### Prerequisites -Before executing the **Test Report** workflow step, **one of the** following steps must be run to generate the report: +Before running the **Test Reports for React Native** step, you must complete certain prerequisites, as detailed in the table below: | Prerequisite Workflow Step | Description | | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | @@ -33,7 +33,7 @@ To able to use the **Test Report** component, not necessary to use both test ste ### Input Variables -For each component, specific input variables are required for its operation on your system. +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). | Variable Name | Description | Status | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------- | From 6743f25a8bc16333dac6947b53b9392fc177c393 Mon Sep 17 00:00:00 2001 From: boztopuz Date: Thu, 14 Nov 2024 12:57:48 +0300 Subject: [PATCH 04/10] Added unsaved changes --- .../app-center-code-push.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md index a82adfe64..de76ceb53 100644 --- a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md +++ b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md @@ -24,7 +24,7 @@ Before running the **App Center CodePush** step, you must complete certain prere ### Input Variables -This step contains some variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). +This step contains some input variable(s). It needs these variable(s) to work. The table below gives explanation for this variable(s). From e67e886339dc3cb5f9889d9d7466d11dc12299fd Mon Sep 17 00:00:00 2001 From: boztopuz Date: Thu, 14 Nov 2024 13:55:57 +0300 Subject: [PATCH 05/10] Changed sensitive variable danger box with the same one for every related docs --- .../app-center-android-distribution.md | 6 +++--- .../appdome-build-to-secure-for-android.md | 6 ++++-- .../appsweep-mobile-security-testing.md | 6 +++--- .../azure-bot-for-detekt-report.md | 6 ++++-- .../browserstack-app-automate-espresso.md | 8 ++++++++ .../common-workflow-steps/aws-device-farm-and-deploy.md | 6 +++--- docs/workflows/common-workflow-steps/azure-board.md | 6 +++--- docs/workflows/common-workflow-steps/custom-script.md | 8 ++++++++ docs/workflows/common-workflow-steps/danger.md | 4 ++-- .../common-workflow-steps/data-theorem-mobile-secure.md | 6 ++++-- .../common-workflow-steps/firebase-app-distribution.md | 6 ++++-- .../common-workflow-steps/fod-mobile-assesment.md | 4 ++-- docs/workflows/common-workflow-steps/ftp-upload.md | 4 ++-- docs/workflows/common-workflow-steps/jira-comment.md | 6 ++++-- .../common-workflow-steps/maestro-cloud-upload.md | 6 ++++-- docs/workflows/common-workflow-steps/marathon-cloud.md | 6 +++--- .../common-workflow-steps/repeato-test-runner.md | 6 ++++-- .../common-workflow-steps/set-environment-variable.md | 6 ++++-- .../workflows/common-workflow-steps/snyk-scan-security.md | 6 ++++-- docs/workflows/common-workflow-steps/testinium.md | 6 ++++-- .../flutter-build-for-ios.md | 2 ++ .../appcenter-ios-distribution.md | 6 +++--- .../appdome-build-to-secure-for-ios.md | 6 +++--- .../azure-bot-for-swiftlint.md | 6 +++--- .../browserstack-app-automation.md | 6 ++++-- .../app-center-code-push.md | 4 ++-- 26 files changed, 94 insertions(+), 54 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index f71344e44..3038ca1c0 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -46,11 +46,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md index 8be72384e..9675c7550 100644 --- a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md @@ -37,9 +37,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::caution +:::danger Sensitive Variables -Confidential information should be entered as a [secret environment variable](https://docs.appcircle.io/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](https://docs.appcircle.io/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index 7bc6f0a48..e565511b0 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -28,11 +28,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md index 451d3d651..3c4ec841e 100644 --- a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md +++ b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md @@ -35,9 +35,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::caution +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -Enter confidential information as [**secret environment variable**](https://docs.appcircle.io/environment-variables/managing-variables#adding-key-and-text-based-value-pairs) and ensure the appropriate [**environment variable group**](https://docs.appcircle.io/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](https://docs.appcircle.io/build/build-profile-configuration/). +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md index ac0524f83..453e079e0 100644 --- a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md +++ b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md @@ -28,6 +28,14 @@ This step contains some input variable(s). It needs these variable(s) to work. T +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. + +::: + | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| | `$AC_BROWSERSTACK_USERNAME` | Specifies the username of the BrowserStack account. Refer to [BrowserStack - Authenticate Test Runs](https://www.browserstack.com/docs/automate/cypress/authentication) for more details. | Required | diff --git a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md index 7a2333428..0045eb9c4 100644 --- a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md +++ b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md @@ -45,11 +45,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/azure-board.md b/docs/workflows/common-workflow-steps/azure-board.md index c27797c05..ff24f2865 100644 --- a/docs/workflows/common-workflow-steps/azure-board.md +++ b/docs/workflows/common-workflow-steps/azure-board.md @@ -47,11 +47,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/custom-script.md b/docs/workflows/common-workflow-steps/custom-script.md index 1d29a0be9..3bfe2cb9c 100644 --- a/docs/workflows/common-workflow-steps/custom-script.md +++ b/docs/workflows/common-workflow-steps/custom-script.md @@ -30,6 +30,14 @@ This step contains some input variable(s). It needs these variable(s) to work. T +:::danger Sensitive Variables + +If you need to use sensitive variable in your script, please do not use these sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. + +::: + | Variable Name | Description | Status | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | `Execute` | You can run your script as **`Bash`** or **`Ruby`** with two different language environments in the **Execute With** input value. | Required | diff --git a/docs/workflows/common-workflow-steps/danger.md b/docs/workflows/common-workflow-steps/danger.md index a59f0bfb7..d4ca8052a 100644 --- a/docs/workflows/common-workflow-steps/danger.md +++ b/docs/workflows/common-workflow-steps/danger.md @@ -45,9 +45,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Avoid hard-coding sensitive information like tokens and API keys directly into the step parameters. +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. diff --git a/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md b/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md index 5cbc29c33..1ffc879bc 100644 --- a/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md +++ b/docs/workflows/common-workflow-steps/data-theorem-mobile-secure.md @@ -55,9 +55,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Confidential information should be entered as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](/build/build-process-management/build-profile-configuration/). +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/firebase-app-distribution.md b/docs/workflows/common-workflow-steps/firebase-app-distribution.md index 636bde6be..505893563 100644 --- a/docs/workflows/common-workflow-steps/firebase-app-distribution.md +++ b/docs/workflows/common-workflow-steps/firebase-app-distribution.md @@ -68,9 +68,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Confidential information should be entered as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](/build/build-process-management/build-profile-configuration/). +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md index 85f816efc..2fa221231 100644 --- a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md +++ b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md @@ -58,9 +58,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Avoid hard-coding sensitive information, like tokens and API keys, directly into the step parameters. +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. diff --git a/docs/workflows/common-workflow-steps/ftp-upload.md b/docs/workflows/common-workflow-steps/ftp-upload.md index 2b2fbaf24..3e29e6b5e 100644 --- a/docs/workflows/common-workflow-steps/ftp-upload.md +++ b/docs/workflows/common-workflow-steps/ftp-upload.md @@ -37,9 +37,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Avoid hard-coding sensitive information, like tokens and API keys directly into the step parameters. +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. diff --git a/docs/workflows/common-workflow-steps/jira-comment.md b/docs/workflows/common-workflow-steps/jira-comment.md index 3863d6ef2..f8460f32a 100644 --- a/docs/workflows/common-workflow-steps/jira-comment.md +++ b/docs/workflows/common-workflow-steps/jira-comment.md @@ -70,9 +70,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -Confidential information should be entered as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [configuration](/build/build-process-management/build-profile-configuration/). +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md index 65f159a62..72febe114 100644 --- a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md +++ b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md @@ -63,9 +63,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Enter confidential information as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, select the appropriate [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) in the [Configuration](/build/build-process-management/build-profile-configuration/). +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/marathon-cloud.md b/docs/workflows/common-workflow-steps/marathon-cloud.md index 3c3f55b5e..566a776eb 100644 --- a/docs/workflows/common-workflow-steps/marathon-cloud.md +++ b/docs/workflows/common-workflow-steps/marathon-cloud.md @@ -49,11 +49,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Avoid hard-coding sensitive variables, such as tokens or API keys, directly into the parameters of the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [**Environment Variables**](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/repeato-test-runner.md b/docs/workflows/common-workflow-steps/repeato-test-runner.md index 1c77e3cc3..e668cfc35 100644 --- a/docs/workflows/common-workflow-steps/repeato-test-runner.md +++ b/docs/workflows/common-workflow-steps/repeato-test-runner.md @@ -38,9 +38,11 @@ Specific input variables are required for the **Repeato Test Runner** to functio -:::danger +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -Confidential information must be entered as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Additionally, ensure that the appropriate [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](/build/build-process-management/build-profile-configuration/). +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/set-environment-variable.md b/docs/workflows/common-workflow-steps/set-environment-variable.md index d67e6aa07..bf5e6d664 100644 --- a/docs/workflows/common-workflow-steps/set-environment-variable.md +++ b/docs/workflows/common-workflow-steps/set-environment-variable.md @@ -27,9 +27,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -Confidential information should be entered as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](/build/build-process-management/build-profile-configuration/). +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/snyk-scan-security.md b/docs/workflows/common-workflow-steps/snyk-scan-security.md index 66e9f461c..009079ee6 100644 --- a/docs/workflows/common-workflow-steps/snyk-scan-security.md +++ b/docs/workflows/common-workflow-steps/snyk-scan-security.md @@ -28,9 +28,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Enter confidential information as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, select the appropriate [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) in the [Configuration](/build/build-process-management/build-profile-configuration/). +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/common-workflow-steps/testinium.md b/docs/workflows/common-workflow-steps/testinium.md index 71cd4b7a4..e86c90a13 100644 --- a/docs/workflows/common-workflow-steps/testinium.md +++ b/docs/workflows/common-workflow-steps/testinium.md @@ -55,9 +55,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Confidential information should be entered as a [secret environment variable](/environment-variables/managing-variables#adding-key-and-text-based-value-pairs). Also, ensure that the [environment variable group](/environment-variables/managing-variables#using-environment-variable-groups-in-builds) is selected in the [Configuration](/build/build-process-management/build-profile-configuration/). +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md index 70a3dedd1..a0a711abe 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md @@ -20,7 +20,9 @@ Before running the **Flutter Build for iOS** step, you must complete certain pre | [**Flutter Install**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-install) | This step will install the Flutter SDK. If a version is not specified, it will install the latest **stable** version. The **Flutter SDK** package must be installed on the system. For this reason, make sure that **Flutter Build for iOS** is used after the **Flutter Install**. | :::caution + Once you have compiled your app for Flutter iOS, the native environment will be built. For this reason, this step should be used before the [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export) step. + ::: diff --git a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md index 47a07a430..7a501d78b 100644 --- a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md +++ b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md @@ -32,11 +32,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](https://docs.appcircle.io/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index b659eefd9..00d9e0125 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -36,11 +36,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md index 310ca77d0..99726e6a9 100644 --- a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md @@ -44,11 +44,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -**Do not hard-code sensitive variables, such as tokens and API keys, directly to the parameters in the step.** +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -We recommend using [Environment Variables](/environment-variables/) groups for such sensitive variables. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md index e6da00e30..69b8c7bcc 100644 --- a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md +++ b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md @@ -33,9 +33,11 @@ The output(s) resulting from the operation of this component are as follows: -:::danger +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. -Do not specify the **Access Key** directly in a hard coded format in steps. Please use [**Environment Variables**](https://docs.appcircle.io/environment-variables/) when using potentially *sensitive variables* like this. +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. ::: diff --git a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md index de76ceb53..07284bb7f 100644 --- a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md +++ b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md @@ -28,9 +28,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Avoid hard-coding sensitive information, like tokens and API keys, directly into the step parameters. +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. From 93dba5053bce2b862d1a730fb1b7ca34d3542d00 Mon Sep 17 00:00:00 2001 From: boztopuz Date: Thu, 14 Nov 2024 14:02:32 +0300 Subject: [PATCH 06/10] fixed broken link for deleted file --- .../appcircle-specific-environment-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/environment-variables/appcircle-specific-environment-variables.md b/docs/environment-variables/appcircle-specific-environment-variables.md index c3b59168a..e6d335027 100644 --- a/docs/environment-variables/appcircle-specific-environment-variables.md +++ b/docs/environment-variables/appcircle-specific-environment-variables.md @@ -82,7 +82,7 @@ For more information on the inputs of the steps and how the variables in the fol | AC_ANDROID_ALIAS | Selected alias name. | | AC_ANDROID_ALIAS_PASSWORD | Selected alias password. | | AC_V2_SIGN | Specifies if signing will use V2. | -| AC_ANDROID_POST_PROCESS_OUTPUT_PATH | Path to the output file generated by the [Android Post-Processing](/workflows/android-specific-workflow-steps/post-processor) step. | +| AC_ANDROID_POST_PROCESS_OUTPUT_PATH | Path to the output file generated by the [Android Post-Processing](/workflows/android-specific-workflow-steps/app-post-processor) step. | | JAVA_HOME | Directory path of the Java JDK installation. | | JAVA_OPTS | Options for Java arguments. For example: `-Xms1536M -Xmx9216M` | | JAVA_VERSION | Version of the Java JDK installed. | From 46d6f8f22eaef89905d0f83447bd57c2c6b238fe Mon Sep 17 00:00:00 2001 From: boztopuz Date: Mon, 18 Nov 2024 12:18:47 +0300 Subject: [PATCH 07/10] Fixed and changed all required links that has wrong format --- .../android-build-for-ui-testing.md | 14 +++++++------- .../android-build.md | 10 +++++----- .../android-dependency-report.md | 8 ++++---- .../android-sign.md | 10 +++++----- .../android-unit-tests.md | 12 ++++++------ .../app-center-android-distribution.md | 12 ++++++------ .../appdome-build-to-secure-for-android.md | 4 ++-- .../appsweep-mobile-security-testing.md | 4 ++-- .../azure-bot-for-detekt-report.md | 4 ++-- .../browserstack-app-automate-espresso.md | 2 +- .../bundle-universal-apk.md | 12 ++++++------ .../android-specific-workflow-steps/detekt.md | 6 +++--- .../firebase-test-lab.md | 2 +- .../gradle-runner.md | 10 +++++----- .../wait-for-android-emulator.md | 10 +++++----- .../common-workflow-steps/add-badge-app-icon.md | 2 +- .../authenticate-with-netrc.md | 2 +- .../aws-device-farm-and-deploy.md | 4 ++-- .../common-workflow-steps/custom-script.md | 4 +++- .../common-workflow-steps/file-size-check.md | 8 ++++---- docs/workflows/common-workflow-steps/git-clone.md | 10 +++++----- .../common-workflow-steps/jira-comment.md | 2 +- .../common-workflow-steps/marathon-cloud.md | 6 +++--- docs/workflows/common-workflow-steps/sonarqube.md | 8 ++++---- .../upload-files-to-amazon-s3.md | 2 +- .../flutter-analyze.md | 6 ++++-- .../flutter-build-for-android.md | 2 +- .../flutter-build-for-ios.md | 6 +++--- .../flutter-build-for-web.md | 4 ++-- .../flutter-install.md | 12 ++++++------ .../flutter-test.md | 6 +++--- .../appcenter-ios-distribution.md | 4 ++-- .../appdome-build-to-secure-for-ios.md | 4 ++-- .../browserstack-app-automation.md | 8 ++++---- .../ios-specific-workflow-steps/carthage.md | 4 ++-- .../cocoapods-deintegrate.md | 2 +- .../cocoapods-install.md | 8 ++++---- .../convert-xcresult-to-xml-html.md | 8 ++++---- .../firebase-upload-dsym.md | 2 +- .../install-certificates-provisions.md | 2 +- .../ios-specific-workflow-steps/slather.md | 12 ++++++------ .../ios-specific-workflow-steps/swiftlint.md | 8 ++++---- .../ios-specific-workflow-steps/xcode-select.md | 8 ++++---- .../xcodebuild-for-devices.md | 12 ++++++------ .../xcodebuild-for-ios-simulator.md | 12 +++++++----- .../xcodebuild-for-testing.md | 10 +++++----- .../xcodebuild-for-unit-and-ui-test.md | 2 +- .../node-install.md | 4 ++-- .../npm-yarn-commands.md | 4 ++-- 49 files changed, 162 insertions(+), 156 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md index 0b2bf3923..216348589 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md +++ b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md @@ -16,13 +16,13 @@ Before running the **Android Build for UI Testing** step, you must complete cert | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Android Build for UI Testing** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Build for UI Testing** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Android Build for UI Testing** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Build for UI Testing** step. | :::caution If you're updating the version via Appcircle, ensure that the following step comes before the **Android Build for UI Testing** step: -- [**Android Increment Build and Version Number**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/increment-build-and-version-number) +- [**Android Increment Build and Version Number**](/workflows/android-specific-workflow-steps/increment-build-and-version-number) ::: @@ -30,8 +30,8 @@ If you're updating the version via Appcircle, ensure that the following step com If you're working with a **React Native Android** project, ensure that the following steps come before the **Android Build for UI Testing** step: -- [**Install Node**](https://docs.appcircle.io/workflows/react-native-specific-workflow-steps/#install-node) -- [**NPM/Yarn Commands**](https://docs.appcircle.io/workflows/react-native-specific-workflow-steps/npm-yarn-commands) +- [**Install Node**](/workflows/react-native-specific-workflow-steps/node-install) +- [**NPM/Yarn Commands**](/workflows/react-native-specific-workflow-steps/npm-yarn-commands) ::: @@ -39,7 +39,7 @@ If you're working with a **React Native Android** project, ensure that the follo :::note -The **[Firebase Test Lab for Android](https://docs.appcircle.io/continuous-testing/firebase-test-lab-for-android/)** step has been added as an example. You can use the APK you produce for UI testing in any component you choose. +The **[Firebase Test Lab for Android](/workflows/android-specific-workflow-steps/firebase-test-lab)** step has been added as an example. You can use the APK you produce for UI testing in any component you choose. ::: @@ -51,8 +51,8 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) step, the variable will be automatically populated. | Required | -| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | +| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/workflows/common-workflow-steps/git-clone) step, the variable will be automatically populated. | Required | +| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. | Optional | ### Output Variables diff --git a/docs/workflows/android-specific-workflow-steps/android-build.md b/docs/workflows/android-specific-workflow-steps/android-build.md index 8c09b617c..9e19bdb9e 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build.md +++ b/docs/workflows/android-specific-workflow-steps/android-build.md @@ -16,7 +16,7 @@ Before running the **Android Build** step, you must complete certain prerequisit | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Git Clone](/workflows/common-workflow-steps/#git-clone) | To initiate the Android build process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the Git Clone step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | +| [Git Clone](/workflows/common-workflow-steps/git-clone) | To initiate the Android build process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the Git Clone step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | @@ -28,10 +28,10 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/workflows/common-workflow-steps/#git-clone) step, the variable will be automatically populated. | Required | -| `$AC_MODULE` | This variable specifies the project module to be build. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration/). In Android Studio, you can locate the available modules for your project. For more information, please refer to [this Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | -| `$AC_VARIANTS` | This variable specifies the project variant to be build. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration/). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | -| `$AC_OUTPUT_TYPE` | This variable specifies the output type for your build file (APK or AAB). This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration/). | Required | +| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/workflows/common-workflow-steps/git-clone) step, the variable will be automatically populated. | Required | +| `$AC_MODULE` | This variable specifies the project module to be build. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can locate the available modules for your project. For more information, please refer to [this Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | +| `$AC_VARIANTS` | This variable specifies the project variant to be build. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | +| `$AC_OUTPUT_TYPE` | This variable specifies the output type for your build file (APK or AAB). This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). | Required | | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. | Optional | | `$AC_GRADLE_BUILD_EXTRA_ARGS` | Extra arguments were passed to build task. For more information, please refer to [this Gradle document](https://docs.gradle.org/current/userguide/writing_build_scripts.html#sec:extra_properties). | Optional | diff --git a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md index 2433959af..c73dad54d 100644 --- a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md +++ b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md @@ -18,7 +18,7 @@ Before running the **Android Dependency Report** step, you must complete certain | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Android Dependency Report** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Dependency Report** step. | +| [**Git Clone**](/build/build-process-management/build-profile-configuration) | To initiate the **Android Dependency Report** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Dependency Report** step. | @@ -30,8 +30,8 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) step, the variable will be automatically populated. | Required | -| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | +| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/build/build-process-management/build-profile-configuration) step, the variable will be automatically populated. | Required | +| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | | `$AC_DEPENDENCY_CONFIGURATION` | Specifies the [configuration](https://docs.gradle.org/current/userguide/declaring_dependencies.html#sec:what-are-dependency-configurations) to resolve for displaying dependency information. The default value is: `implementation`. | Required | | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. The default value is: `./` | Optional | @@ -45,7 +45,7 @@ The output(s) resulting from the operation of this component are as follows: :::danger -If you wish to review or download the Android Dependencies Report, you can find them directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts). To do this, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step follows the **Android Dependency Report** workflow step. +If you wish to review or download the Android Dependencies Report, you can find them directly from [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). To do this, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step follows the **Android Dependency Report** workflow step. diff --git a/docs/workflows/android-specific-workflow-steps/android-sign.md b/docs/workflows/android-specific-workflow-steps/android-sign.md index 20fbc0bc7..e34cee521 100644 --- a/docs/workflows/android-specific-workflow-steps/android-sign.md +++ b/docs/workflows/android-specific-workflow-steps/android-sign.md @@ -12,7 +12,7 @@ import Screenshot from '@site/src/components/Screenshot'; :::info -This step follows the [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) step to sign the unsigned build output if the project doesn't include a *keystore*. If your project includes a *keystore*, the build application step will generate a signed artifact. If you do not disable this step, your artifact will be unsigned and then re-signed using the *keystore* selected in the **Configuration** or in this step. +This step follows the [**Android Build**](/workflows/android-specific-workflow-steps/android-build) step to sign the unsigned build output if the project doesn't include a *keystore*. If your project includes a *keystore*, the build application step will generate a signed artifact. If you do not disable this step, your artifact will be unsigned and then re-signed using the *keystore* selected in the **Configuration** or in this step. ::: @@ -22,8 +22,8 @@ Before running the **Android Sign** step, you must complete certain prerequisite | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step relies on the **Android Build** step and the **Git Clone** step is necessary for the **Android Build** step to run successfully. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | :::caution @@ -35,7 +35,7 @@ If a step other than the **Android Build** step is used to build an app, then th :::danger -To share the signed apps created as an output of this step or to view them on the **Download Artifacts** page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/#export-build-artifacts) step is included in your workflow after this step. +To share the signed apps created as an output of this step or to view them on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your workflow after this step. ::: @@ -49,7 +49,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T |-----------------------------|----------------------------------------------|--------| | `$AC_APK_PATH` | The path of the *APK* file. This path is automatically generated in the **Android Build** step. You may need to modify this input variable to provide a different path. | Required | | `$AC_AAB_PATH` | The path of the *AAB* file. This path is automatically generated in the **Android Build** step. You may need to modify this input variable to provide a different path. | Required | -| `$AC_ANDROID_KEYSTORE_PATH` | *Keystore* file can be selected in the **Configuration**. This value will be auto-generated depending on your *keystore* file selection in [signing configuration on Appcircle](https://docs.appcircle.io/build/building-android-applications#signing). | Required | +| `$AC_ANDROID_KEYSTORE_PATH` | *Keystore* file can be selected in the **Configuration**. This value will be auto-generated depending on your *keystore* file selection in [signing configuration on Appcircle](/build/platform-build-guides/building-android-applications#signing). | Required | | `$AC_ANDROID_KEYSTORE_PASSWORD` | Password for the selected *keystore* file. This value will be auto-generated based on your *keystore* file selection. | Required | | `$AC_ANDROID_ALIAS` | Alias name for the selected *keystore* file. This value will be auto-generated depending on your **Configuration** | | `$AC_ANDROID_ALIAS_PASSWORD` | Alias password for the selected *keystore* file. This value will be auto-generated depending on your **Configuration** | diff --git a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md index 7181aa9a5..17c892b85 100644 --- a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md +++ b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md @@ -10,7 +10,7 @@ import Screenshot from '@site/src/components/Screenshot'; The **Android Unit Tests** workflow step executes the unit tests within your project, ensuring comprehensive test coverage. The results of these tests will be included in the artifact archive for further analysis and review. -Please check out this document for more information: [Running Android Unit Tests](https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests) +Please check out this document for more information: [Running Android Unit Tests](/continuous-testing/android-testing/running-android-unit-tests) ### Prerequisites @@ -18,13 +18,13 @@ Before running the **Android Unit Tests** step, you must complete certain prereq | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Android Unit Tests** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Unit Tests** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Android Unit Tests** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Unit Tests** step. | :::danger -If you wish to view the test results on Appcircle's Test Reports page, it is essential to use the [Test Reports](https://github.com/appcircleio/appcircle-test-report-component) step after the **Android Unit Tests**. Please check out this document for more information: [Generating Test Report](https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) +If you wish to view the test results on Appcircle's Test Reports page, it is essential to use the [Test Reports for Android](/workflows/android-specific-workflow-steps/test-reports-for-android) step after the **Android Unit Tests**. Please check out this document for more information: [Generating Test Report](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) @@ -38,9 +38,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) step, the variable will be automatically populated. | Required | -| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | -| `$AC_VARIANTS` | This variable specifies the project variant to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | +| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/workflows/common-workflow-steps/git-clone) step, the variable will be automatically populated. | Required | +| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | +| `$AC_VARIANTS` | This variable specifies the project variant to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. The default value is: `./` | Optional | ### Output Variables diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index 3038ca1c0..1f42bb27e 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -17,9 +17,9 @@ Please note that you can also distribute your app via Appcircle. Utilizing Appci For more details, please refer to the following links: -- [Appcircle Testing Distribution](https://docs.appcircle.io/distribute/) -- [Appcircle Enterprise App Store](https://docs.appcircle.io/enterprise-app-store/) -- [Appcircle Publish](https://docs.appcircle.io/publish-module/) +- [Appcircle Testing Distribution](/testing-distribution) +- [Appcircle Enterprise App Store](/enterprise-app-store) +- [Appcircle Publish](/publish-module) ::: @@ -29,8 +29,8 @@ Before running the **App Center Android Distribute** step, you must complete cer | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the Android Build (or alternative build steps). | -| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the Android Build (or alternative build steps). | +| [**Android Sign**](/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::danger @@ -62,7 +62,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_APPCENTER_APPNAME` | The name of the app is in the App Center. The app's name can be identified in its URL, such as `https://appcenter.ms/users/JohnDoe/apps/myapp` for a user-owned app (where **myapp** is the app name) and `https://appcenter.ms/orgs/Appcircle/apps/myapp` for an org-owned app (the owner is **myapp**). | Required | | `$AC_APPCENTER_GROUPS` | Specifies the group names in the App Center. For more than one group name to be distributed, you must separate them with a comma. For example: `group0,group1,..,groupn` | Optional | | `$AC_APPCENTER_STORE` | Specifies the store name. For example: `App Store`, `Google Play`, and `Intune`. | Optional | -| `$AC_APPCENTER_RELEASE_NOTES_PATH` | Specifies the release note path. If you use the [**Publishing Release Notes**](https://docs.appcircle.io/workflows/common-workflow-steps/publish-release-notes) component before this step, `release-notes.txt` will be used as release notes. The default value is `AC_OUTPUT_DIR/release-notes.txt`. | Optional | +| `$AC_APPCENTER_RELEASE_NOTES_PATH` | Specifies the release note path. If you use the [**Publishing Release Notes**](/workflows/common-workflow-steps/publish-release-notes) component before this step, `release-notes.txt` will be used as release notes. The default value is `AC_OUTPUT_DIR/release-notes.txt`. | Optional | | `$AC_APPCENTER_MAPPING_PATH` | Specifies the path of the `mapping.txt` file. Example: `$AC_REPOSITORY_DIR/build/app/outputs/mapping/release/mapping.txt` | Optional | | `$AC_APPCENTER_MANDATORY` | Specifies whether the update should be considered mandatory. The options are `true` and `false`. The default value is `false`. | Optional | | `$AC_APPCENTER_NOTIFY` | Notify testers of this release. The options are `true` and `false`. The default value is `false`. | Optional | diff --git a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md index 9675c7550..a956731dd 100644 --- a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md @@ -20,8 +20,8 @@ Before running the **Appdome Build-2Secure for Android** step, you must complete | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | -| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | The app required for this step is generated by the **Android Build** (or alternative build steps). | +| [**Android Sign**](/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::danger diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index e565511b0..c6975e2be 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -18,7 +18,7 @@ Before running the **AppSweep Mobile Security Testing** step, you must complete | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The **AppSweep Mobile Security Testing** step requires the repository to be cloned from the Git provider before it can function properly. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The **AppSweep Mobile Security Testing** step requires the repository to be cloned from the Git provider before it can function properly. | @@ -39,7 +39,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | Variable Name | Description | Status | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | `$AC_APPSWEEP_API_KEY` | Specifies the API key of the AppSweep account. You can create an API key in the API Keys section of your project settings on the AppSweep website. | Required | -| `$AC_APPSWEEP_VARIANT` | Specifies the project variant to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | +| `$AC_APPSWEEP_VARIANT` | Specifies the project variant to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. | Optional | ### Output Variables diff --git a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md index 3c4ec841e..5c7c4a6e3 100644 --- a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md +++ b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md @@ -12,7 +12,7 @@ The **Azure DevOps Bot for Detekt Report** step analyzes your [Detekt report](ht :::caution -[Danger](https://danger.systems/) operates on a similar principle, allowing use of the [Danger step](https://docs.appcircle.io/workflows/common-workflow-steps/#code-reviews-with-danger) with platforms such as [GitHub](https://github.com/), [GitLab](https://about.gitlab.com/), and [Bitbucket](https://bitbucket.org/product/guides/getting-started/overview#a-brief-overview-of-bitbucket). However, Danger currently does not support Azure DevOps. +[Danger](https://danger.systems/) operates on a similar principle, allowing use of the [Danger step](/workflows/common-workflow-steps/danger) with platforms such as [GitHub](https://github.com/), [GitLab](https://about.gitlab.com/), and [Bitbucket](https://bitbucket.org/product/guides/getting-started/overview#a-brief-overview-of-bitbucket). However, Danger currently does not support Azure DevOps. For more information, refer to the Appcircle blog post about Danger: - [**Danger in CI: Automate Your Mobile Code Reviews**](https://appcircle.io/blog/danger-in-ci-automate-your-mobile-code-reviews). @@ -25,7 +25,7 @@ Before running the **Azure DevOps Bot for Detekt Report** step, you must complet | Prerequisite Workflow Step | Description | |-------------------------------------------------|--------------------------------------------------| - | [**Detekt**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#detekt) | In order to generate the [Detekt report](https://detekt.dev/docs/introduction/reporting/), the **Detekt** step must be executed beforehand. | + | [**Detekt**](/workflows/android-specific-workflow-steps/detekt) | In order to generate the [Detekt report](https://detekt.dev/docs/introduction/reporting/), the **Detekt** step must be executed beforehand. | diff --git a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md index 453e079e0..76e2e297c 100644 --- a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md +++ b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md @@ -18,7 +18,7 @@ Before running the **BrowserStack App Automate - Espresso** step, you must compl | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Android Build for UI Testing**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android app outputs for processing. | +| [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android app outputs for processing. | diff --git a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md index a2b0ed15c..64da4b05e 100644 --- a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md +++ b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md @@ -18,8 +18,8 @@ Before running the **Bundle Universal Apk** step, you must complete certain prer | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | This step is necessary to generate the **AAB** app that will be converted to an **APK**. | -| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | This step is necessary to generate the **AAB** app that will be converted to an **APK**. | +| [**Android Sign**](/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. If your app is already signed in the build step, you can skip this step. | :::caution @@ -39,10 +39,10 @@ This step contains some input variable(s). It needs these variable(s) to work. T | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | `$AC_BUNDLETOOL_VERSION` | Specifies the version of **Bundletool** to install. The default value is `1.11.2`. To install a different version, please refer to [this document](https://github.com/google/bundletool/releases). | Required | | `$AC_SIGNED_AAB_PATH` | The optional path of the signed **AAB** file to convert the **APK**. If this step runs after the **Android Sign** step, the variable will be automatically populated. If the signing takes place in the build step and you want to directly enter the **APK** you received from the **Android Build** step here, you can change the variable to `$AC_APK_PATH`. | Required | -| `$AC_ANDROID_KEYSTORE_PATH` | (Autogenerated) The path to the keystore file selected via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). For more details, please refer to the [Android Keystores](https://docs.appcircle.io/signing-identities/android-keystores) documentation. | Required | -| `$AC_ANDROID_KEYSTORE_PASSWORD` | (Autogenerated) The password for the keystore file, generated according to the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). For more details, please refer to the [Android Keystores](https://docs.appcircle.io/signing-identities/android-keystores) documentation. | Required | -| `$AC_ANDROID_ALIAS` | (Autogenerated) The alias for the Android Keystore, generated according to the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). For more details, please refer to the [Android Keystores](https://docs.appcircle.io/signing-identities/android-keystores) documentation. | Required | -| `$AC_ANDROID_ALIAS_PASSWORD` | (Autogenerated) The password for the Android Keystore alias, generated according to the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). For more details, please refer to the [Android Keystores](https://docs.appcircle.io/signing-identities/android-keystores) documentation. | Required | +| `$AC_ANDROID_KEYSTORE_PATH` | (Autogenerated) The path to the keystore file selected via the build [Configuration](/build/build-process-management/build-profile-configuration). For more details, please refer to the [Android Keystores](/signing-identities/android-keystores) documentation. | Required | +| `$AC_ANDROID_KEYSTORE_PASSWORD` | (Autogenerated) The password for the keystore file, generated according to the build [Configuration](/build/build-process-management/build-profile-configuration). For more details, please refer to the [Android Keystores](/signing-identities/android-keystores) documentation. | Required | +| `$AC_ANDROID_ALIAS` | (Autogenerated) The alias for the Android Keystore, generated according to the build [Configuration](/build/build-process-management/build-profile-configuration). For more details, please refer to the [Android Keystores](/signing-identities/android-keystores) documentation. | Required | +| `$AC_ANDROID_ALIAS_PASSWORD` | (Autogenerated) The password for the Android Keystore alias, generated according to the build [Configuration](/build/build-process-management/build-profile-configuration). For more details, please refer to the [Android Keystores](/signing-identities/android-keystores) documentation. | Required | ### Output Variables diff --git a/docs/workflows/android-specific-workflow-steps/detekt.md b/docs/workflows/android-specific-workflow-steps/detekt.md index 24ff3123a..aabab3c7d 100644 --- a/docs/workflows/android-specific-workflow-steps/detekt.md +++ b/docs/workflows/android-specific-workflow-steps/detekt.md @@ -18,7 +18,7 @@ Before running the **Detekt** step, you must complete certain prerequisites, as | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) | The **Git Clone** step is necessary to fetch the repository before conducting code checks and must precede the **Detekt** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The **Git Clone** step is necessary to fetch the repository before conducting code checks and must precede the **Detekt** step. | @@ -37,13 +37,13 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::danger -If `$AC_DETEKT_SAVE_REPORT` is set to `true`, place the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step after the **Detekt** step to ensure proper transfer of outputs to the [Download Artifacts](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. +If `$AC_DETEKT_SAVE_REPORT` is set to `true`, place the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step after the **Detekt** step to ensure proper transfer of outputs to the [Download Artifacts](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. ::: ### Output Variables -The output is not stored in any variable. If `AC_DETEKT_SAVE_REPORT` is set to `true`, the file output will be saved in the `$AC_PROJECT_PATH/$AC_MODULE/build/reports` directory (check these variables on the [Appcircle-Specific Environment Variables](https://docs.appcircle.io/environment-variables/appcircle-specific-environment-variables#ios--android-common-environment-variables) page). If you've added the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step after the **Detekt** step, this output will also be accessible in the [Download Artifacts](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. +The output is not stored in any variable. If `AC_DETEKT_SAVE_REPORT` is set to `true`, the file output will be saved in the `$AC_PROJECT_PATH/$AC_MODULE/build/reports` directory (check these variables on the [Appcircle-Specific Environment Variables](/environment-variables/appcircle-specific-environment-variables#ios--android-common-environment-variables) page). If you've added the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step after the **Detekt** step, this output will also be accessible in the [Download Artifacts](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. --- diff --git a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md index e6f395e24..8d7753d1b 100644 --- a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md +++ b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md @@ -16,7 +16,7 @@ Before running the **Firebase Test Lab for Android** step, you must complete cer | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Android Build for UI Testing**](./android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android application outputs for processing. | +| [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The **Android Build for UI Testing** step must be executed to obtain the necessary Android application outputs for processing. | In addition to the steps you need to run on Appcircle, there are also adjustments you need to make on the Firebase Test Lab side. These adjustments can be made as follows: diff --git a/docs/workflows/android-specific-workflow-steps/gradle-runner.md b/docs/workflows/android-specific-workflow-steps/gradle-runner.md index 4cbd05adf..22dc000f8 100644 --- a/docs/workflows/android-specific-workflow-steps/gradle-runner.md +++ b/docs/workflows/android-specific-workflow-steps/gradle-runner.md @@ -16,7 +16,7 @@ Before running the **Gradle Runner** step, you must complete certain prerequisit | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | To initiate the **Gradle Runner** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Gradle Runner** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Gradle Runner** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Gradle Runner** step. | @@ -28,9 +28,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) step, the variable will be automatically populated. | Required | -| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | -| `$AC_VARIANTS` | This variable specifies the project variant to be built. This variable can also be set via the build [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | +| `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/workflows/common-workflow-steps/git-clone) step, the variable will be automatically populated. | Required | +| `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | +| `$AC_VARIANTS` | This variable specifies the project variant to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | | `$AC_OUTPUT_DIR` | Specifies the directory path for the generated app files. | Required | | `$AC_GRADLE_TASK` | Specifies the name of the Gradle task. Refer to the documentation for detailed information: [List available tasks](https://docs.gradle.org/current/userguide/tutorial_using_tasks.html#list_available_tasks). | Required | | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. The default value is: `./` | Optional | @@ -42,7 +42,7 @@ As the output may vary depending on the task you execute, there is no specific o :::caution -If there is an output generated, ensure to use the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps#export-build-artifacts) step afterward to ensure it is included in the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts) page. +If there is an output generated, ensure to use the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step afterward to ensure it is included in the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page. ::: diff --git a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md index 5738b89d9..4bfe36f1d 100644 --- a/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md +++ b/docs/workflows/android-specific-workflow-steps/wait-for-android-emulator.md @@ -10,11 +10,11 @@ import Screenshot from '@site/src/components/Screenshot'; The **Wait for Android Emulator** step waits for the Android Emulator to boot. You must use this step before running any UI tests. -For additional details, please refer to the [**Emulator**](https://docs.appcircle.io/infrastructure/android-build-infrastructure/#emulator) documentation. +For additional details, please refer to the [**Emulator**](/infrastructure/android-build-infrastructure#emulator) documentation. :::danger -Ensure that you select the **Intel Pool** in the Configuration tab, as the **Wait for Android Emulator** step will not function in the **M1 Pool**. Please refer to [this documentation](https://docs.appcircle.io/build/build-process-management/build-profile-configuration/#project-details-configuration) for selecting a pool in Configuration. +Ensure that you select the **Intel Pool** in the Configuration tab, as the **Wait for Android Emulator** step will not function in the **M1 Pool**. Please refer to [this documentation](/build/build-process-management/build-profile-configuration#project-details-configuration) for selecting a pool in Configuration. ::: @@ -24,8 +24,8 @@ Before running the **Wait for Android Emulator** step, you must complete certain | Prerequisite Workflow Step | Description | | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build) | This step is necessary to obtain the Android outputs required for processing. Without adding this step beforehand, the **Wait for Android Emulator** step will still function, but the app will not be installed. | -| [**Android Sign**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. Failure to add this step beforehand will result in the **Wait for Android Emulator** step still functioning, but since the app is not signed, there may be installation issues. If your app is already signed, you can skip this step. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | This step is necessary to obtain the Android outputs required for processing. Without adding this step beforehand, the **Wait for Android Emulator** step will still function, but the app will not be installed. | +| [**Android Sign**](/workflows/android-specific-workflow-steps/android-sign) | If you intend to use a signed app, this step must be executed beforehand to process the output. Failure to add this step beforehand will result in the **Wait for Android Emulator** step still functioning, but since the app is not signed, there may be installation issues. If your app is already signed, you can skip this step. | :::caution @@ -43,7 +43,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_TEST_DEVICE` | Specifies the device for the test. The default value is `Pixel_3a`. If you use an emulator other than `Pixel_3a`, you need to create it manually. To install a different device, please follow [this document](https://docs.appcircle.io/infrastructure/android-build-infrastructure/#emulator). | Required | +| `$AC_TEST_DEVICE` | Specifies the device for the test. The default value is `Pixel_3a`. If you use an emulator other than `Pixel_3a`, you need to create it manually. To install a different device, please follow [this document](/infrastructure/android-build-infrastructure#emulator). | Required | | `$AC_TEST_ADB_WAIT_SECONDS` | Specifies the number of seconds the component must wait for the emulator to boot. The default value is `300`. | Optional | | `$AC_TEST_ADB_ARGUMENTS` | ADB arguments for the device. For additional details about ADB arguments, please refer to the [Android Debug Bridge](https://developer.android.com/tools/adb) documentation. The default value is: `-no-window -no-audio -no-boot-anim -netdelay none -no-snapshot -wipe-data -gpu auto`. You may add new arguments, but don't change the default ones, such as `no-window`. | Required | | `$AC_SIGNED_APK_PATH` | The optional full path of the signed APK file to install after the emulator boots. If this step runs after the **Android Sign** step, the variable will be automatically populated. If the signing takes place in the build step and you want to directly enter the APK you received from the **Android Build** step here, you can change the variable to `$AC_APK_PATH`. | Optional | diff --git a/docs/workflows/common-workflow-steps/add-badge-app-icon.md b/docs/workflows/common-workflow-steps/add-badge-app-icon.md index ff3a4a8a7..b40640407 100644 --- a/docs/workflows/common-workflow-steps/add-badge-app-icon.md +++ b/docs/workflows/common-workflow-steps/add-badge-app-icon.md @@ -21,7 +21,7 @@ Before running the **Add a Badge to Your App Icon** step, you must complete cert | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](/workflows/common-workflow-steps#git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | :::caution diff --git a/docs/workflows/common-workflow-steps/authenticate-with-netrc.md b/docs/workflows/common-workflow-steps/authenticate-with-netrc.md index 7b23c3219..057c6556f 100644 --- a/docs/workflows/common-workflow-steps/authenticate-with-netrc.md +++ b/docs/workflows/common-workflow-steps/authenticate-with-netrc.md @@ -30,7 +30,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::danger -When using the **Authenticate with Netrc** component, you need to specify a token or password in the `$AC_NETRC_PASS` parameter within the component. For security reasons, we recommend using [**Enviroment Variables**](https://docs.appcircle.io/environment-variables/) in steps where you need to specify the token and password. +When using the **Authenticate with Netrc** component, you need to specify a token or password in the `$AC_NETRC_PASS` parameter within the component. For security reasons, we recommend using [**Enviroment Variables**](/environment-variables) in steps where you need to specify the token and password. ::: diff --git a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md index 0045eb9c4..92277cea7 100644 --- a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md +++ b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md @@ -28,8 +28,8 @@ Pay attention to the dependent step on whichever platform you are working on. | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Android Build for UI Testing**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The Android Build for UI Testing workflow step is tailored to build your Android test application using Gradle Wrapper (gradlew) for the designated architectures outlined in your project. | -| [**Xcodebuild Build for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/build-and-test/xcodebuild-for-testing) | This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks. | +| [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The Android Build for UI Testing workflow step is tailored to build your Android test application using Gradle Wrapper (gradlew) for the designated architectures outlined in your project. | +| [**Xcodebuild Build for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) | This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks. | #### For iOS diff --git a/docs/workflows/common-workflow-steps/custom-script.md b/docs/workflows/common-workflow-steps/custom-script.md index 3bfe2cb9c..5b63dd092 100644 --- a/docs/workflows/common-workflow-steps/custom-script.md +++ b/docs/workflows/common-workflow-steps/custom-script.md @@ -182,7 +182,9 @@ mv lint-results* $AC_OUTPUT_DIR/ This document provides a sample custom script written in Ruby that can be integrated into your CI/CD pipeline to enforce a minimum test coverage threshold. The script is designed to break the pipeline if the covered test result falls below a specified percentage. :::danger -Please note that this custom script must be placed after the [**Test Reports**](https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) step in the workflow. + +Please note that this custom script must be placed after the [**Test Reports**](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) step in the workflow. + ::: ```ruby diff --git a/docs/workflows/common-workflow-steps/file-size-check.md b/docs/workflows/common-workflow-steps/file-size-check.md index d1be8d13a..b529fb13b 100644 --- a/docs/workflows/common-workflow-steps/file-size-check.md +++ b/docs/workflows/common-workflow-steps/file-size-check.md @@ -14,10 +14,10 @@ The workflow steps that need to be executed before running the **File Size Check | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator) | If your project is an **iOS** project using **Objective-C/Swift** or **React Native**, you should use this step to generate the file before checking the app file size. This step generates the **IPA** file. | -| [**Flutter Build for iOS**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps/#flutter-build-for-ios) | If your project is an **iOS** project using **Flutter**, you should use this step to generate the file before checking the app file size. This step generates an **IPA** file. | -| [**Android Build**](https://docs.appcircle.io/workflows/android-specific-workflow-steps#android-build) | If your project is an **Android** project using **Java/Kotlin** or **React Native**, you should use this step to generate the file before checking the app file size. This step generates **APK** or **AAB** files. | -| [**Flutter Build for Android**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps/#flutter-build-for-android) | If your project is an **Android** project using **Flutter**, you should use this step to generate the file before checking the app file size. This step generates **APK** or **AAB** files. | +| [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) | If your project is an **iOS** project using **Objective-C/Swift** or **React Native**, you should use this step to generate the file before checking the app file size. This step generates the **IPA** file. | +| [**Flutter Build for iOS**](/workflows/flutter-specific-workflow-steps/flutter-build-for-ios) | If your project is an **iOS** project using **Flutter**, you should use this step to generate the file before checking the app file size. This step generates an **IPA** file. | +| [**Android Build**](/workflows/android-specific-workflow-steps/android-build) | If your project is an **Android** project using **Java/Kotlin** or **React Native**, you should use this step to generate the file before checking the app file size. This step generates **APK** or **AAB** files. | +| [**Flutter Build for Android**](/workflows/flutter-specific-workflow-steps/flutter-build-for-android) | If your project is an **Android** project using **Flutter**, you should use this step to generate the file before checking the app file size. This step generates **APK** or **AAB** files. | :::danger diff --git a/docs/workflows/common-workflow-steps/git-clone.md b/docs/workflows/common-workflow-steps/git-clone.md index d4ac8d0e7..39ace4cc3 100644 --- a/docs/workflows/common-workflow-steps/git-clone.md +++ b/docs/workflows/common-workflow-steps/git-clone.md @@ -8,7 +8,7 @@ import Screenshot from '@site/src/components/Screenshot'; # Git Clone -The **Git Clone** step is used to fetch the source code repository from a Git provider, such as [**GitHub**](https://docs.appcircle.io/build/adding-a-build-profile/connecting-to-github), [**GitLab**](https://docs.appcircle.io/build/adding-a-build-profile/connecting-to-gitlab), [**Bitbucket**](https://docs.appcircle.io/build/adding-a-build-profile/connecting-to-bitbucket), or [**Azure DevOps**](https://docs.appcircle.io/build/adding-a-build-profile/connecting-to-azure), and clone it into the runner where the build and deployment processes take place. This step ensures that the latest version of the codebase is available for subsequent build and deployment steps. +The **Git Clone** step is used to fetch the source code repository from a Git provider, such as [**GitHub**](/build/manage-the-connections/adding-a-build-profile/connecting-to-github), [**GitLab**](/build/manage-the-connections/adding-a-build-profile/connecting-to-gitlab), [**Bitbucket**](/build/manage-the-connections/adding-a-build-profile/connecting-to-bitbucket), or [**Azure DevOps**](/build/manage-the-connections/adding-a-build-profile/connecting-to-azure), and clone it into the runner where the build and deployment processes take place. This step ensures that the latest version of the codebase is available for subsequent build and deployment steps. ### Prerequisites @@ -16,7 +16,7 @@ Before running the **Git Clone** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Activate SSH Private Key**](https://docs.appcircle.io/workflows/common-workflow-steps/#activate-ssh-key) | This step sets up your SSH key on the build machine **if you used one to connect your repository with SSH**. | +| [**Activate SSH Private Key**](/workflows/common-workflow-steps/active-ssh-private-key) | This step sets up your SSH key on the build machine **if you used one to connect your repository with SSH**. | :::caution @@ -40,15 +40,15 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::danger -After connecting the repository, the following [**Reserved Environment Variables**](https://docs.appcircle.io/environment-variables/appcircle-specific-environment-variables), which **Git Clone** uses as input, will be automatically populated. Ensure that the variable you provide has a value if you intend to make any changes. **The required variables must not be left empty**. +After connecting the repository, the following [**Reserved Environment Variables**](/environment-variables/appcircle-specific-environment-variables), which **Git Clone** uses as input, will be automatically populated. Ensure that the variable you provide has a value if you intend to make any changes. **The required variables must not be left empty**. ::: | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_GIT_URL` | URL of the repository. After the [**provider connection**](https://docs.appcircle.io/build/adding-a-build-profile/) is completed with the Git provider, these values will be set automatically. | Required | +| `$AC_GIT_URL` | URL of the repository. After the [**provider connection**](/build/manage-the-connections/adding-a-build-profile) is completed with the Git provider, these values will be set automatically. | Required | | `$AC_GIT_COMMIT` | Commit of the repository. This value will come from the Git provider. When a new commit is pushed, Appcircle fetches the details of the latest commit. | Optional | -| `$AC_GIT_BRANCH` | Branch of the repository. You can find more details about [**branch management**](https://docs.appcircle.io/build/build-profile-branch-operations). The branch information selected before starting manual build on the interface is automatically included here. | Optional | +| `$AC_GIT_BRANCH` | Branch of the repository. You can find more details about [**branch management**](/build/build-process-management/build-profile-branch-operations). The branch information selected before starting manual build on the interface is automatically included here. | Optional | | `$AC_GIT_TAG` | Tag of the repository. If you have tags in your repository, Appcircle can start a build according to the tags. | Optional | | `$AC_GIT_LFS` | Used to specify whether large files will be downloaded. The default value is `false`. | Optional | | `$AC_GIT_SUBMODULE` | Used to specify whether the submodule should be cloned. | Optional | diff --git a/docs/workflows/common-workflow-steps/jira-comment.md b/docs/workflows/common-workflow-steps/jira-comment.md index f8460f32a..c06ef0aa0 100644 --- a/docs/workflows/common-workflow-steps/jira-comment.md +++ b/docs/workflows/common-workflow-steps/jira-comment.md @@ -100,7 +100,7 @@ The required inputs for authorization vary based on the type of Jira instance (O | `$AC_JIRA_EMAIL` | The email associated with your Jira account. This field is required for using API tokens instead of PAT. | Optional | | `$AC_JIRA_TOKEN` | User's API Token. If this value is fill, the Jira e-mail field must be filled. Only Jira Cloud users can use API Token. You can create token from [here](https://id.atlassian.com/manage-profile/security/api-tokens) | Optional | | `$AC_JIRA_PAT` | Specify the Personal Access Token for Jira authentication. Only Jira On-Prem users can use PAT. | Optional | -| `$AC_JIRA_ISSUE` | The ID or key of the issue. Refer to the [documentation](https://docs.appcircle.io/integrations/jira-integration) for instructions on extracting this information from branch names or commit messages. | Required | +| `$AC_JIRA_ISSUE` | The ID or key of the issue. Refer to the [documentation](/workflows/common-workflow-steps/jira-comment) for instructions on extracting this information from branch names or commit messages. | Required | | `$AC_JIRA_FAIL_TRANSITION` | Transition ID or name for the failed step. Optionally change the status of your issue if the previous state fails. Ensure that the `Always run this step even if the previous steps fail` switch is enabled for this feature to work. | Optional | | `$AC_JIRA_SUCCESS_TRANSITION` | Transition ID or name for the successful step. Optionally change the status of your issue if the previous state succeeds. | Optional | | `$AC_JIRA_TEMPLATE_V2` | The comment template used to post a comment if [Jira REST API Version 2](#jira-rest-api-version-reference) is selected. Variables prefixed with `$` will be replaced during the build process. Refer to [this header](#changing-template) to modify the template. | Required | diff --git a/docs/workflows/common-workflow-steps/marathon-cloud.md b/docs/workflows/common-workflow-steps/marathon-cloud.md index 566a776eb..815cc685b 100644 --- a/docs/workflows/common-workflow-steps/marathon-cloud.md +++ b/docs/workflows/common-workflow-steps/marathon-cloud.md @@ -25,13 +25,13 @@ Please note that this component works separately on both the native **Android** | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) | After the Xcodebuild for Testing step runs, the test IPA paths `$AC_TEST_IPA_PATH` and `$AC_UITESTS_RUNNER_PATH` will be created automatically. So that the **Marathon Cloud** component depends on these paths. | -| [**Android Build for UI Testing**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | Once the Android Build for UI Testing step is completed, the test APK paths `$AC_APK_PATH` and `$AC_TEST_APK_PATH` are automatically generated. The **Marathon Cloud** component relies on these paths. | +| [**Xcodebuild for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) | After the Xcodebuild for Testing step runs, the test IPA paths `$AC_TEST_IPA_PATH` and `$AC_UITESTS_RUNNER_PATH` will be created automatically. So that the **Marathon Cloud** component depends on these paths. | +| [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | Once the Android Build for UI Testing step is completed, the test APK paths `$AC_APK_PATH` and `$AC_TEST_APK_PATH` are automatically generated. The **Marathon Cloud** component relies on these paths. | :::danger When using this component for the **iOS platform**, do not forget to change the **`Destination`** value in the **Xcodebuild for Testing** step. This value will be `generic/platform=iOS` by default. This means that it creates a generic test `IPA` for all iOS devices. Since the Marathon Cloud component runs on a specific test device, you need to change this value. For example, `platform=iOS Simulator,name=iPhone 15 Pro,OS=17.2`. -Please note that if you do not change this parameter, the Marathon Cloud component will fail and the pipeline will break. For further information, please follow the [**Xcodebuild for Testing documentation**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/xcodebuild-for-testing). +Please note that if you do not change this parameter, the Marathon Cloud component will fail and the pipeline will break. For further information, please follow the [**Xcodebuild for Testing documentation**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing). ::: #### For Android diff --git a/docs/workflows/common-workflow-steps/sonarqube.md b/docs/workflows/common-workflow-steps/sonarqube.md index f3657594c..2c4a0b279 100644 --- a/docs/workflows/common-workflow-steps/sonarqube.md +++ b/docs/workflows/common-workflow-steps/sonarqube.md @@ -18,7 +18,7 @@ Before running the **SonarQube** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | If you intend to retrieve the **SonarQube Scanner** parameters from the `sonar-project.properties` file in your repository, it's essential to employ the **Git Clone** step before the **SonarQube** step. After the **Git Clone** step is completed, it generates the `AC_REPOSITORY_DIR` variable, which is used as input for the **SonarQube** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | If you intend to retrieve the **SonarQube Scanner** parameters from the `sonar-project.properties` file in your repository, it's essential to employ the **Git Clone** step before the **SonarQube** step. After the **Git Clone** step is completed, it generates the `AC_REPOSITORY_DIR` variable, which is used as input for the **SonarQube** step. | ### Input Variables @@ -28,7 +28,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::caution -Please note that **SonarQube** is a commercial code quality analysis tool. The parameters required for the scanner to work should be used as [**Enviroment Variables**](https://docs.appcircle.io/environment-variables/) as they may create security vulnerabilities. You can obtain these parameters by contacting your DevOps team. +Please note that **SonarQube** is a commercial code quality analysis tool. The parameters required for the scanner to work should be used as [**Enviroment Variables**](/environment-variables) as they may create security vulnerabilities. You can obtain these parameters by contacting your DevOps team. ::: @@ -52,7 +52,7 @@ If you want to include your test results in the **SonarQube** analysis, always r :::danger -SonarQube accepts `XML` format files to analyse test results. In order to analyse your test results, do not forget to convert the test results to `XML` format by running the [**Convert Xcresult to HTML/XML**](https://github.com/appcircleio/appcircle-ios-xcresult-convert-html-xml-component) step after the [**Xcodebuild for Unit and UI testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-unit-and-ui-tests) step. +SonarQube accepts `XML` format files to analyse test results. In order to analyse your test results, do not forget to convert the test results to `XML` format by running the [**Convert Xcresult to HTML/XML**](/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html) step after the [**Xcodebuild for Unit and UI testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) step. ::: @@ -63,7 +63,7 @@ If you intend to send the test result file obtained from the Android unit test o :::caution -Ensure that the test result path provided to **SonarQube** as a property matches the test result path generated by the [**Android Unit Tests**](https://docs.appcircle.io/workflows/android-specific-workflow-steps/#android-unit-tests) step, and direct the output to that location. +Ensure that the test result path provided to **SonarQube** as a property matches the test result path generated by the [**Android Unit Tests**](/workflows/android-specific-workflow-steps/android-unit-tests) step, and direct the output to that location. ::: diff --git a/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md b/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md index a96037d27..54aafe03a 100644 --- a/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md +++ b/docs/workflows/common-workflow-steps/upload-files-to-amazon-s3.md @@ -43,7 +43,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::info -It is highly recommended to add the keys as [secret environment variables](../../.././environment-variables/managing-variables) instead of typing them here for security purposes. +It is highly recommended to add the keys as [secret environment variables](/environment-variables/managing-variables) instead of typing them here for security purposes. ::: diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md index 4fc704929..87c78de78 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md @@ -16,13 +16,15 @@ Before running the **Flutter Analyze** step, you must complete certain prerequis | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | -| [**Flutter Install**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-install) | This step will install the [Flutter SDK](https://flutter-ko.dev/development/tools/sdk/releases) release. If the version is not specified, it will install the latest **stable** version. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | +| [**Flutter Install**](/workflows/flutter-specific-workflow-steps/flutter-install) | This step will install the [Flutter SDK](https://flutter-ko.dev/development/tools/sdk/releases) release. If the version is not specified, it will install the latest **stable** version.| :::danger + This step is particularly dependent on the Flutter Install step. If the Flutter SDK is not installed, the step will give an error that the required command was not found. + ::: ### Input Variables diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md index 2af16b90a..6cb3f51a8 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md @@ -16,7 +16,7 @@ Before running the **Flutter Build for Android** step, you must complete certain | Prerequisite Workflow Step | Description | | -------------------------- | --------------------------------------------------------------------------------------------- | -| [**Git Clone**](/workflows/common-workflow-steps/#git-clone) | This step fetches the repository that needs to be built from the specified branch. It is essential for initiating the Flutter Android build process. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step fetches the repository that needs to be built from the specified branch. It is essential for initiating the Flutter Android build process. | diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md index a0a711abe..8186389d7 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md @@ -16,12 +16,12 @@ Before running the **Flutter Build for iOS** step, you must complete certain pre | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | -| [**Flutter Install**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-install) | This step will install the Flutter SDK. If a version is not specified, it will install the latest **stable** version. The **Flutter SDK** package must be installed on the system. For this reason, make sure that **Flutter Build for iOS** is used after the **Flutter Install**. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | +| [**Flutter Install**](/workflows/flutter-specific-workflow-steps/flutter-install) | This step will install the Flutter SDK. If a version is not specified, it will install the latest **stable** version. The **Flutter SDK** package must be installed on the system. For this reason, make sure that **Flutter Build for iOS** is used after the **Flutter Install**. | :::caution -Once you have compiled your app for Flutter iOS, the native environment will be built. For this reason, this step should be used before the [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export) step. +Once you have compiled your app for Flutter iOS, the native environment will be built. For this reason, this step should be used before the [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) step. ::: diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md index 78335750f..07566226c 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md @@ -17,7 +17,7 @@ Before running the **​Flutter Build for Web** step, you must complete certain | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step clones your project from the connected Git provider and creates the `$AC_REPOSITORY_DIR` variable, which defaults to `$AC_FLUTTER_PROJECT_DIR`. | -| [**Flutter Install**](./flutter-install) | This step installs the [Flutter SDK](https://flutter-ko.dev/development/tools/sdk/releases). If no version is specified, it installs the latest **stable** version. | +| [**Flutter Install**](/workflows/flutter-specific-workflow-steps/flutter-install) | This step installs the [Flutter SDK](https://flutter-ko.dev/development/tools/sdk/releases). If no version is specified, it installs the latest **stable** version. | @@ -57,7 +57,7 @@ To deploy apps to Amplify, you can use Git, manual uploads, or Amazon S3 buckets Since Appcircle supports automated Amazon S3 uploads, you can automatically deploy your apps from Appcircle to Amazon S3 and then sync your S3 bucket with Amplify Console with the following steps: -- First, set up a [Flutter Web App build](../../.././build/platform-build-guides/building-flutter-applications/building-flutter-web-applications). +- First, set up a [Flutter Web App build](/build/platform-build-guides/building-flutter-applications/building-flutter-web-applications). - Then, add an [Upload to Amazon S3 step to your workflow](/workflows/common-workflow-steps/upload-files-to-amazon-s3) and configure it to receive the web app artifact as the input of the step. - To set up Amplify Console and S3 sync, first go to Amplify and [set up a manual deployment](https://docs.aws.amazon.com/amplify/latest/userguide/manual-deploys.html). - Then, follow the steps [in this AWS blog post](https://aws.amazon.com/blogs/mobile/deploy-files-s3-dropbox-amplify-console/) to automate deployments from an S3 bucket to Amplify. diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md index f76d52f4b..bfc8842a6 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md @@ -23,11 +23,11 @@ There are no prerequisites required before using the **Flutter Install** step. :::caution These steps depend on Flutter installation and can only be used after the **Flutter Install** step: -- [**Flutter Build for iOS**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-build-for-ios) -- [**Flutter Build for Android**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-build-for-android) -- [**Flutter Analyze**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-analyze) -- [**Flutter Test**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-test) -- [**Flutter Build for Web**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-build-for-web) +- [**Flutter Build for iOS**](/workflows/flutter-specific-workflow-steps/flutter-build-for-ios) +- [**Flutter Build for Android**](/workflows/flutter-specific-workflow-steps/flutter-build-for-android) +- [**Flutter Analyze**](/workflows/flutter-specific-workflow-steps/flutter-analyze) +- [**Flutter Test**](/workflows/flutter-specific-workflow-steps/flutter-test) +- [**Flutter Build for Web**](/workflows/flutter-specific-workflow-steps/flutter-build-for-web) ::: @@ -48,7 +48,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_SELECTED_FLUTTER_VERSION`| Specifies the Flutter version to install. Defaults to: `stable`. The version you set in the [Configuration](https://docs.appcircle.io/build/building-flutter-applications/#build-configuration-for-flutter-applications) section will override this setting. | Optional | +| `$AC_SELECTED_FLUTTER_VERSION`| Specifies the Flutter version to install. Defaults to: `stable`. The version you set in the [Configuration](/build/platform-build-guides/building-flutter-applications#build-configuration-for-flutter-ios-applications) section will override this setting. | Optional | :::caution diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md index 853fd45d4..9aade193c 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md @@ -16,8 +16,8 @@ Before running the **Flutter Test** step, you must complete certain prerequisite | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | -| [**Flutter Install**](https://docs.appcircle.io/workflows/flutter-specific-workflow-steps#flutter-install) | This step will install the [Flutter SDK](https://flutter-ko.dev/development/tools/sdk/releases) release. If the version is not specified, it will install the latest **stable** version. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your project through the connected Git provider and create the `$AC_REPOSITORY_DIR` variable. | +| [**Flutter Install**](/workflows/flutter-specific-workflow-steps/flutter-install) | This step will install the [Flutter SDK](https://flutter-ko.dev/development/tools/sdk/releases) release. If the version is not specified, it will install the latest **stable** version.| @@ -45,7 +45,7 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `AC_TEST_RESULT_PATH` | This path is created after the test results are reported. If you are using the [**Export Build Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step, it can be accessed directly from [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). | +| `AC_TEST_RESULT_PATH` | This path is created after the test results are reported. If you are using the [**Export Build Artifact**](/workflows/common-workflow-steps/export-build-artifacts) step, it can be accessed directly from [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). | --- diff --git a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md index 7a501d78b..d791b9cd4 100644 --- a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md +++ b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md @@ -16,13 +16,13 @@ Before running the **App Center iOS Distrubiton** step, you must complete certai | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export) | This step will build your application in ARM architecture and generate an `IPA` and `dSYM` file. | +| [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) | This step will build your application in ARM architecture and generate an `IPA` and `dSYM` file. | :::caution -Note that if you do not use this step after the [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export), Appcircle will not find **IPA** and **dSYM** files to distribute to the **App Center**. +Note that if you do not use this step after the [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices), Appcircle will not find **IPA** and **dSYM** files to distribute to the **App Center**. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index 00d9e0125..1f4f80477 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -62,7 +62,7 @@ The output(s) resulting from the operation of this component are as follows: :::caution -To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. ::: @@ -75,4 +75,4 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w --- To access the source code of this component, please use the following link: -[https://github.com/appcircleio/appcircle-ios-appdome-component](https://github.com/appcircleio/appcircle-ios-appdome-component) +https://github.com/appcircleio/appcircle-ios-appdome-component diff --git a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md index 69b8c7bcc..a11a3c814 100644 --- a/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md +++ b/docs/workflows/ios-specific-workflow-steps/browserstack-app-automation.md @@ -17,7 +17,7 @@ Before running the **BrowserStack App Automate (XCUI)** step, you must complete | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) | After the [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) step runs, the test IPA paths (`$AC_TEST_IPA_PATH` and `$AC_UITESTS_RUNNER_PATH`) will be created automatically. So that the **BrowserStack** component depends on these paths. | +| [**Xcodebuild for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) | After the [**Xcodebuild for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) step runs, the test IPA paths (`$AC_TEST_IPA_PATH` and `$AC_UITESTS_RUNNER_PATH`) will be created automatically. So that the **BrowserStack** component depends on these paths. | @@ -45,8 +45,8 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v |-------------------------------|------------------------------------------------|--------| | `$AC_BROWSERSTACK_USERNAME` | Username of the **BrowserStack** account. It should come from the **BrowserStack** account. | Required | | `$AC_BROWSERSTACK_ACCESS_KEY` | Access key for the **BrowserStack** account. It should come from the **BrowserStack** account. For more information, please follow [this document](https://www.browserstack.com/docs/iaam/security/manage-access-keys). | Required | -| `$AC_TEST_IPA_PATH` | Full path of the IPA file. This path will automatically generate in [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) step.| Required | -| `$AC_UITESTS_RUNNER_PATH` | Full path of the *-Runner.app. This path will automatically generate in [**Xcodebuild for Testing**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-testing) step. | Required | +| `$AC_TEST_IPA_PATH` | Full path of the IPA file. This path will automatically generate in [**Xcodebuild for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) step.| Required | +| `$AC_UITESTS_RUNNER_PATH` | Full path of the *-Runner.app. This path will automatically generate in [**Xcodebuild for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) step. | Required | | `$AC_BROWSERSTACK_PAYLOAD` | `$AC_BROWSERSTACK_APP_URL` and `$AC_BROWSERSTACK_TEST_URL` will be auto generated. Please check the [documentation](https://www.browserstack.com/docs/app-automate/api-reference/xcuitest/builds#execute-a-build) for more details about the payload. | Optional | | `$AC_BROWSERSTACK_TIMEOUT` | **BrowserStack** plans a timeout in seconds. If there is any problem in BrowserStack, these variables will break the pipeline after a certain time. The default variable is **600 seconds**. | Required | @@ -54,4 +54,4 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v To access the source code of this component, please use the following link: -[https://github.com/appcircleio/appcircle-browserstack-xcui-component](https://github.com/appcircleio/appcircle-browserstack-xcui-component) \ No newline at end of file +https://github.com/appcircleio/appcircle-browserstack-xcui-component \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/carthage.md b/docs/workflows/ios-specific-workflow-steps/carthage.md index cebb4a84e..ad29e9471 100644 --- a/docs/workflows/ios-specific-workflow-steps/carthage.md +++ b/docs/workflows/ios-specific-workflow-steps/carthage.md @@ -19,7 +19,7 @@ Before running the **Carthage** step, you must complete certain prerequisites, a | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) | This step clones your git repo on the runner where the build process will take place so that the necessary workflow operations can be performed. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step clones your git repo on the runner where the build process will take place so that the necessary workflow operations can be performed. | @@ -38,7 +38,7 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| | `$AC_CARTHAGE_COMMAND` | Specifies the Carthage command to run. Defaults to `bootstrap`. **Possible values:** `bootstrap`, `update` | Required | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone).| Optional | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after [Git Clone](/workflows/common-workflow-steps/git-clone).| Optional | | `$AC_CARTFILE_PATH` | Specifies the path where the Cartfile resides. Defaults to the repository directory. **DO NOT** include Cartfile, this is only the path. **This value will be appended** to `$AC_REPOSITORY_DIR`. **Example:** `./` or `./subpath-to-cartfile/` | Optional | | `$AC_CARTHAGE_FLAGS` | Specifies additional flags after the Carthage command. The default value is empty. **For Xcode 12 and above, make sure to include** `--use-xcframeworks` **here**. To shorten the build time, make sure to specify the platform: `--platform iOS`. Example usage: `--platform iOS --use-xcframeworks` | Optional | diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md index 614031d0a..b62edd005 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md @@ -37,7 +37,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| | `$AC_XCODEPROJ_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. Empty value will look for an `.xcodeproj` file. | Optional | -| `$AC_REPOSITORY_DIR` | Specifies the directory where the repository is cloned. This path is generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Optional | +| `$AC_REPOSITORY_DIR` | Specifies the directory where the repository is cloned. This path is generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Optional | | `$AC_COCOAPODS_VERSION` | Specifies the CocoaPods version. If you need a specific version, provide it here as hardcoded, and the system will automatically install that version. | Optional | --- diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md index a77600c41..5a18ef6db 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md @@ -16,7 +16,7 @@ Before running the **Cocoapods Install** step, you must complete certain prerequ | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | @@ -28,13 +28,13 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration). | Required | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](/build/build-process-management/build-profile-configuration). | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_COCOAPODS_VERSION` | Specifies the CocoaPods version. If there is a specific version you want to use, give it here as hardcoded, and the system will automatically install the given version. | Optional | :::info -Please note that the CocoaPods Install step uses the default system [**CocoaPods version**](https://docs.appcircle.io/infrastructure/ios-build-infrastructure#ios-build-agent-stacks). If you want to use a specific version, please enter it hardcoded in the CocoaPods Version parameter in the step. +Please note that the CocoaPods Install step uses the default system [**CocoaPods version**](/infrastructure/ios-build-infrastructure#ios-build-agent-stacks). If you want to use a specific version, please enter it hardcoded in the CocoaPods Version parameter in the step. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md index 23131c078..3480cf8ce 100644 --- a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md +++ b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md @@ -8,7 +8,7 @@ import Screenshot from '@site/src/components/Screenshot'; # Convert Xcresult to HTML/XML -After the [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/continuous-testing/running-ios-unit-and-ui-tests) step runs, it generates a `test_result.xcresult` file. In specific cases, this test file must be converted to another format. The **Convert Xcresult to HTML/XML** step is used for converting this test file to `HTML` and `XML` formats. +After the [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) step runs, it generates a `test_result.xcresult` file. In specific cases, this test file must be converted to another format. The **Convert Xcresult to HTML/XML** step is used for converting this test file to `HTML` and `XML` formats. ### Prerequisites @@ -17,7 +17,7 @@ Before running the **Convert Xcresult to HTML/XML** step, you must complete cert | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/continuous-testing/running-ios-unit-and-ui-tests) | This step allows you to run unit and UI tests on your project. After this step runs, the related path, `AC_TEST_RESULT_PATH` will be generated automatically. | +| [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) | This step allows you to run unit and UI tests on your project. After this step runs, the related path, `AC_TEST_RESULT_PATH` will be generated automatically. | :::caution @@ -48,11 +48,11 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|-------------------------------------| -| `AC_CONVERTED_TEST_RESULT_PATH` | Specifies the path where the converted result is stored. Users can access this path via this variable. Additionally, it will be available for download in the [**Download Artifact**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. | +| `AC_CONVERTED_TEST_RESULT_PATH` | Specifies the path where the converted result is stored. Users can access this path via this variable. Additionally, it will be available for download in the [**Download Artifact**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) section. | :::caution -To view the converted test reports on the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts/#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the converted test reports on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md b/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md index 43b083b35..ea5b8cb24 100644 --- a/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md +++ b/docs/workflows/ios-specific-workflow-steps/firebase-upload-dsym.md @@ -16,7 +16,7 @@ Before running the **Firebase Upload dSYM** step, you must complete certain prer | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-devices-archive--export) | This step will build your application, create an Archive file, and generate `.ipa`. The Archive file contains the `.dSYM` file. Please use **Firebase Upload dSYM** step after this step. | +| [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) | This step will build your application, create an Archive file, and generate `.ipa`. The Archive file contains the `.dSYM` file. Please use **Firebase Upload dSYM** step after this step. | diff --git a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md index 08f211792..f5e26a91c 100644 --- a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md +++ b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md @@ -23,7 +23,7 @@ If you are using an automatic code sign, you can remove this step. Since automat | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | Clone your repository to the runner machine. Use the Install Certificates and Provisiong Profiles step after this step. This step will clone your repository to be able to use provisioning profiles and certificates. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | Clone your repository to the runner machine. Use the Install Certificates and Provisiong Profiles step after this step. This step will clone your repository to be able to use provisioning profiles and certificates. | :::danger diff --git a/docs/workflows/ios-specific-workflow-steps/slather.md b/docs/workflows/ios-specific-workflow-steps/slather.md index 1ed727d84..610d48e5c 100644 --- a/docs/workflows/ios-specific-workflow-steps/slather.md +++ b/docs/workflows/ios-specific-workflow-steps/slather.md @@ -16,8 +16,8 @@ Before running the **Slather** step, you must complete certain prerequisites, as | Prerequisite Workflow Step | Description | |------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | This step will clone your repository. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | -| [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-unit-and-ui-tests) | This step executes your unit and UI tests, generating a `.xcresult` file. This file serves as the mandatory test result input for **Slather**. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your repository. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | +| [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) | This step executes your unit and UI tests, generating a `.xcresult` file. This file serves as the mandatory test result input for **Slather**. | @@ -37,10 +37,10 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------|--------------------------------------|----------------------------------| | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. It's generated after the **Git Clone** step. | Required | -| `$AC_TEST_RESULT_PATH` | This is the path of **`.xcresult`** file. It will be generated after the [**Xcodebuild for Unit and UI Test**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-unit-and-ui-tests) step. | Required | -| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). | Required | -| `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). But if you have a different location, specify this parameter. | Required | -| `$AC_WORKSPACE_PATH` | Specifies the workspace path. For example : **`./appcircle.xcworkspace`**. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). But if you have a different location, specify this parameter. | Optional | +| `$AC_TEST_RESULT_PATH` | This is the path of **`.xcresult`** file. It will be generated after the [**Xcodebuild for Unit and UI Test**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) step. | Required | +| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | +| `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). But if you have a different location, specify this parameter. | Required | +| `$AC_WORKSPACE_PATH` | Specifies the workspace path. For example : **`./appcircle.xcworkspace`**. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). But if you have a different location, specify this parameter. | Optional | | `$AC_COVERAGE_FORMAT` | Exported coverage format. You can change the output format of the coverage test results for Slather with the **Coverage Type** variable. The default value is **cobertura**. | Optional | | `$AC_CONFIGURATION_NAME`| If you have a configuration that you want to specify while **Slather** is running, you can add it to the command line with the **Configuration** parameter. | Optional | | `$AC_SLATHER_OPTIONS` | If you want to add an extra command to the command line, you can do it with the **Extra Option** variable. | Optional | diff --git a/docs/workflows/ios-specific-workflow-steps/swiftlint.md b/docs/workflows/ios-specific-workflow-steps/swiftlint.md index 70c1b3b3a..5ec9d2f87 100644 --- a/docs/workflows/ios-specific-workflow-steps/swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/swiftlint.md @@ -15,20 +15,20 @@ Before running the **SwiftLint** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed, and then SwiftLint will be run. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the input variable for CocoaPods and SwiftLint. | -| [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install)| This step will install the dependencies in the project before SwiftLint can run. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed, and then SwiftLint will be run. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the input variable for CocoaPods and SwiftLint. | +| [**Cocoapods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install)| This step will install the dependencies in the project before SwiftLint can run. | :::danger -If you are using **CocoaPods**, note that this step is dependent on the [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) step. Otherwise, the SwiftLint component will **fail**, and the **pipeline will break.** +If you are using **CocoaPods**, note that this step is dependent on the [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) step. Otherwise, the SwiftLint component will **fail**, and the **pipeline will break.** ::: :::caution -If you are using **Swift Package Manager (SPM)**, do not use this step. SPM packages will be compiled in other steps that work with **Xcode**, such as [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcodebuild-for-devices-archive--export). +If you are using **Swift Package Manager (SPM)**, do not use this step. SPM packages will be compiled in other steps that work with **Xcode**, such as [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices). If you have SPM in your project and you are using the SwiftLint component in your workflow, the Linter component will give an error because it cannot find the required dependencies. diff --git a/docs/workflows/ios-specific-workflow-steps/xcode-select.md b/docs/workflows/ios-specific-workflow-steps/xcode-select.md index cbd618674..79a7fc194 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcode-select.md +++ b/docs/workflows/ios-specific-workflow-steps/xcode-select.md @@ -16,13 +16,13 @@ There are no prerequisites required before using the **Xcode Select** step. :::danger -Always use this step **before** [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#cocoapods-install) and [**Xcodebuild for Devices**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-devices-archive--export). If you have other **Xcode related** steps, such as [**Xcodebuild for iOS Simulators**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-ios-simulator) and [**Xcodebuild for Unit and UI Tests**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/#xcodebuild-for-unit-and-ui-tests), **don't forget** to use before them. +Always use this step **before** [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) and [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices). If you have other **Xcode related** steps, such as [**Xcodebuild for iOS Simulators**](/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator) and [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test), **don't forget** to use before them. ::: :::caution -Please **don't forget** to select the **Xcode version** from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration) first. +Please **don't forget** to select the **Xcode version** from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration) first. ::: @@ -30,7 +30,7 @@ Please **don't forget** to select the **Xcode version** from [Configuration](htt ### Version Change -- To select an Xcode version, open [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration) in the build profile. +- To select an Xcode version, open [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration) in the build profile. @@ -49,7 +49,7 @@ Appcircle provides new versions of Xcode (including beta versions) within 24 hou A version other than the Xcode versions on the configuration page should not be entered manually as the Xcode select workflow argument. Because the Xcode versions on the configuration page are the versions installed on runners. Entering an unavailable Xcode version may cause the build to fail. -You can review the documentation for detailed information about the Xcode version selection [here](/self-hosted-appcircle/self-hosted-runner/configure-runner/manage-pools/#pool-based-xcode-version-selection). +You can review the documentation for detailed information about the Xcode version selection [here](/self-hosted-appcircle/self-hosted-runner/configure-runner/manage-pools#select-pool-for-build-profile). ::: diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md index c262ed6f3..a88329fb9 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md @@ -22,9 +22,9 @@ Before running the **Xcodebuild for Devices** step, you must complete certain pr | Require Workflow Step | Description | | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/#git-clone) | The repository that needs to be built must be fetched from the Git provider. **Xcodebuild for Devices** should be used after this step. | -| [**Xcode Select**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcode-select-version) | In this step, select the Xcode version to build. **Xcodebuild for Devices** should be used after this step. | -| [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) | This step installs all pod dependencies for project. **Xcodebuild for Devices** should be used after this step. If you use SPM (Swift Package Manager), it is not necessary to use. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository that needs to be built must be fetched from the Git provider. **Xcodebuild for Devices** should be used after this step. | +| [**Xcode Select**](/workflows/ios-specific-workflow-steps/xcode-select) | In this step, select the Xcode version to build. **Xcodebuild for Devices** should be used after this step. | +| [**Cocoapods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) | This step installs all pod dependencies for project. **Xcodebuild for Devices** should be used after this step. If you use SPM (Swift Package Manager), it is not necessary to use. | :::danger @@ -41,11 +41,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_OUTPUT_DIR_PATH` | This variable specifies the path of the artifacts that will be generated after the build is complete. | Required | -| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in **`Configuration => Build Scheme`**, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). | Required | +| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in **`Configuration => Build Scheme`**, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: -quiet | | -| `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). | Required | +| `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_CERTIFICATES` | This variable specifies the path of the certificates to be signed. | Required | | `$AC_BUNDLE_IDENTIFIERS` | This variable holds the Bundle Identifier of the application to be built. | Required | | `$AC_PROVISIONING_PROFILES` | This variable specifies the path of provisioning profiles to be signed. | Required | diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md index 1b88ae0d2..ba1a6a1c0 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md @@ -16,8 +16,8 @@ Before running the **Xcodebuild for iOS Simulator** step, you must complete cert | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcode Select**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcode-select-version) | This step selects the Xcode version that is specified. | -| [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) | This step installs all the dependencies of the pod file. | +| [**Xcode Select**](/workflows/ios-specific-workflow-steps/xcode-select) | This step selects the Xcode version that is specified. | +| [**Cocoapods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) | This step installs all the dependencies of the pod file. | @@ -36,18 +36,20 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_OUTPUT_DIR_PATH` | Specifies the path for outputs for generated artifacts. | Required | -| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). | Required | +| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_SIMULATOR_ARCH` | Specifies the CPU architecture for the simulator build. The default variable is **`arm64`**. | Optional | | `$AC_SIMULATOR_NAME` | Destination name of the simulator. Ex. `iPhone 14`. If you set a simulator name, the build will be installed into the given simulator. Please be aware that setting the simulator name invalidates the `AC_SIMULATOR_ARCH` option. | Required | | `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: -quiet | Optional | -| `$AC_PROJECT_PATH` | Specifies the project path. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). For example: `./appcircle.xcodeproj`. | Required | +| `$AC_PROJECT_PATH` | Specifies the project path. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). For example: `./appcircle.xcodeproj`. | Required | | `$AC_CONFIGURATION_NAME` | You can build your project with any configuration you want. Specify the configuration as hard coded. Appcircle will automatically add this configuration to the xcodebuild command. For example; **`Debug`**. | Optional | | `$AC_COMPILER_INDEX_STORE_ENABLE` | You can disable indexing during the build for a faster build. The default value is **`No`**. | Required | :::caution + Be aware of which OS version you used; the simulator type should match that OS version. For example, if you use the [**latest OS version**](https://developer.apple.com/documentation/ios-ipados-release-notes), you can not use the **iPhone 14** simulator. + ::: ### Output Variables diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md index 54033373f..6f70aeee8 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md @@ -8,7 +8,7 @@ import Screenshot from '@site/src/components/Screenshot'; # Xcodebuild for Testing -This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks like [**BrowserStack**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#browserstack-app-automate---xcui) or [**Testinium**](/workflows/common-workflow-steps/testinium). +This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks like [**BrowserStack**](/workflows/ios-specific-workflow-steps/browserstack-app-automation) or [**Testinium**](/workflows/common-workflow-steps/testinium). ### Prerequisites @@ -16,8 +16,8 @@ Before running the **Xcodebuild for Testing** step, you must complete certain pr | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcode Select**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#xcode-select-version) | This step selects the Xcode version that is specified. | -| [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps#cocoapods-install) | This step installs all the dependencies of the pod file. | +| [**Xcode Select**](/workflows/ios-specific-workflow-steps/xcode-select) | This step selects the Xcode version that is specified. | +| [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) | This step installs all the dependencies of the pod file. | @@ -36,9 +36,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|----------------------| | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | -| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). | Required | +| `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: **`-quiet`** | Optional | -| `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. This variable comes from [Configuration](https://docs.appcircle.io/build/building-ios-applications#build-configuration). | Required | +| `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. This variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_CONFIGURATION_NAME` | You can build your project with any configuration you want. Specify the configuration as hard-coded. Appcircle will automatically add this configuration to the xcodebuild command. For example; **`Debug`** | Optional | | `$AC_COMPILER_INDEX_STORE_ENABLE` | You can disable indexing during the build for a faster build. The default value is **`No`**. | Optional | | `$AC_DESTINATION` | This parameter determines for which destination the application will be built and IPA will be generated. The default value is **`generic/platform=iOS`**, which means that it will be built for all iOS devices. | Required | diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md index 4b3c9fdee..d34df7a43 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md @@ -63,7 +63,7 @@ Ensure the simulator type matches the OS version used. For example, if you use t :::caution -To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. ::: diff --git a/docs/workflows/react-native-specific-workflow-steps/node-install.md b/docs/workflows/react-native-specific-workflow-steps/node-install.md index da30f2c1a..ef07b011b 100644 --- a/docs/workflows/react-native-specific-workflow-steps/node-install.md +++ b/docs/workflows/react-native-specific-workflow-steps/node-install.md @@ -16,7 +16,7 @@ Before running the **Install Node** step, you must complete certain prerequisite | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) | Clone the selected repository to the build machine. Please use the [**Install Node**](https://docs.appcircle.io/workflows/react-native-specific-workflow-steps#install-node) step after this step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | Clone the selected repository to the build machine. Please use the **Install Node** step after this step. | :::caution @@ -34,7 +34,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| -| `$AC_SELECTED_NODE_VERSION` | This step takes only the **node version** variable. You can specify the version directly in the step if you wish. Or you can get it from build [**Configurations**](https://docs.appcircle.io/build/building-react-native-applications#build-configuration-for-react-native-ios-applications). | Optional | +| `$AC_SELECTED_NODE_VERSION` | This step takes only the **node version** variable. You can specify the version directly in the step if you wish. Or you can get it from build [**Configurations**](/build/platform-build-guides/building-react-native-applications#build-configuration-for-react-native-ios-applications). | Optional | :::caution diff --git a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md index a3c11f11b..9b7dea990 100644 --- a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md +++ b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md @@ -16,7 +16,7 @@ Before running the **NPM/Yarn Commands** step, you must complete certain prerequ | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Install Node**](https://docs.appcircle.io/workflows/react-native-specific-workflow-steps#install-node) | This step will install Node modules for your application. Please note that the **NPM/Yarn Commands** step should be used after this step. | +| [**Install Node**](/workflows/react-native-specific-workflow-steps/node-install) | This step will install Node modules for your application. Please note that the **NPM/Yarn Commands** step should be used after this step. | @@ -28,7 +28,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_NPM_COMMAND_ARGS` | The NPM command to run. You can add different command parameters directly. The default is: `npm/yarn install` | Optional | --- From 143bc8303af12957b928f6bda274e96bae9c8922 Mon Sep 17 00:00:00 2001 From: ftmzhrsckldr Date: Fri, 22 Nov 2024 14:12:09 +0300 Subject: [PATCH 08/10] Fixed in-doc linking --- docs/workflows/android-specific-workflow-steps/index.md | 3 +-- .../test-reports-for-android.md | 3 ++- .../common-workflow-steps/build-cache/cache-pull.md | 4 ++-- .../common-workflow-steps/build-cache/cache-push.md | 8 ++++---- .../how-to-share-file-between-build-profiles.md | 2 +- .../build-cache/how-to-share-file-between-pipelines.md | 4 ++-- .../flutter-specific-workflow-steps/flutter-install.md | 2 +- .../ios-specific-workflow-steps/cocoapods-install.md | 2 +- docs/workflows/ios-specific-workflow-steps/index.md | 3 +-- .../workflows/ios-specific-workflow-steps/xcode-select.md | 2 +- .../ios-specific-workflow-steps/xcodebuild-for-testing.md | 2 +- .../react-native-ui-test.md | 2 +- .../react-native-unit-test.md | 2 +- 13 files changed, 19 insertions(+), 20 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/index.md b/docs/workflows/android-specific-workflow-steps/index.md index 56e9eb66f..4ad8f37a9 100644 --- a/docs/workflows/android-specific-workflow-steps/index.md +++ b/docs/workflows/android-specific-workflow-steps/index.md @@ -159,8 +159,7 @@ This step runs given Gradle task. This component provides detailed reports and insights on the results of Android app tests conducted. For detailed information on the usage of **Test Reports for Android**, please refer to the documentation: -[https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests#generating-test-report](https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) - +- [Generating Test Report](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) Test Reports for Android diff --git a/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md b/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md index d404a3c5b..d56edfaad 100644 --- a/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/test-reports-for-android.md @@ -17,7 +17,8 @@ This component supports the following test and coverage formats: - [**Cobertura**](https://cobertura.github.io/cobertura) - [**lcov.info**](https://lcov-viewer.netlify.app) -For additional details, please refer to the document: [**Generating Test Report**](https://docs.appcircle.io/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) +For additional details, please refer to the document: +- [**Generating Test Report**](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) ### Prerequisites diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md index 2b1402d18..a84e24ca2 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md @@ -34,7 +34,7 @@ There are no prerequisites required before using the **Cache Pull** step. This component does not require any prerequisite steps for operation. The only thing necessary for the component to work as expected is to utilize the cached files before the step in which they will be used. Additionally, an important prerequisite for this step to function properly is that the files to be used must have been cached in previous builds. -For example, in the screenshot, to use cached files for Cocoapods, the **Cache Pull** step should be used before the [**Cocoapods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/cocoapods-install) step. +For example, in the screenshot, to use cached files for Cocoapods, the **Cache Pull** step should be used before the [**Cocoapods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) step. @@ -55,7 +55,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |----------------------------|------------------------------------------------|--------| | `$AC_CACHE_LABEL` | User defined cache label to identify one cache from others. Both [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) and **Cache Pull** steps should have the same value to match. | Required | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository path. This path will be generated after running the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) step. | Optional | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository path. This path will be generated after running the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Optional | --- diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-push.md b/docs/workflows/common-workflow-steps/build-cache/cache-push.md index 257ae33c6..e4c6d5366 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-push.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-push.md @@ -38,7 +38,7 @@ Before running the **Cache Push** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) | If the folders to be cached are in the repo directory, the **Git Clone** step must be used before. This step will generate the [`AC_REPOSITORY_DIR`](#input-variables) path. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | If the folders to be cached are in the repo directory, the **Git Clone** step must be used before. This step will generate the [`AC_REPOSITORY_DIR`](#input-variables) path. | :::danger @@ -66,7 +66,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | `$AC_CACHE_LABEL` | User defined cache label to identify one cache from others. Both **Cache Push** and **Cache Pull** steps should have the same value to match. | Required | | `$AC_CACHE_INCLUDED_PATHS` | Specifies the files and folders that should be in the cache. Multiple glob patterns can be provided as a colon-separated list. For example; `.gradle:app/build` or `Pods:Podfile.lock`. | Required | | `$AC_CACHE_EXCLUDED_PATHS` | Specifies the files and folders that should be ignored from the cache. Multiple glob patterns can be provided as a colon-separated list. For example, `.gradle/*.lock:*.apk`. | Optional | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository path. This path will be generated after running the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps/git-clone) step. | Optional | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository path. This path will be generated after running the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Optional | :::tip @@ -76,11 +76,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T ### Output Variables -You cannot reach the cache archive file directly by yourself. But you can see cache file updates and track changes to cache at the end of the build pipeline from '[Download Artifacts](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) > `ac_cache.zip`'. Also, build logs have some useful information about the cache mechanism and how included and excluded paths are processed. You can see the produced cache file size from the build logs. (The size of the cache file affects upload and download durations.) +You cannot reach the cache archive file directly by yourself. But you can see cache file updates and track changes to cache at the end of the build pipeline from '[Download Artifacts](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) > `ac_cache.zip`'. Also, build logs have some useful information about the cache mechanism and how included and excluded paths are processed. You can see the produced cache file size from the build logs. (The size of the cache file affects upload and download durations.) :::caution -To view the generated artifacts on the [**Download Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](https://docs.appcircle.io/workflows/common-workflow-steps/export-build-artifacts) step is included in the [workflow](/workflows) after this step. +To view the generated artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in the [workflow](/workflows) after this step. ::: diff --git a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md index 5951a88a1..58159bea1 100644 --- a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md +++ b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-build-profiles.md @@ -33,7 +33,7 @@ As an example, **master** and **development** branches were used, but you can ap Please note that the organizational structure of Appcircle is designed in such a way as to prevent any **security vulnerabilities**. Consequently, exchanging files between organizations or sub-organizations **is not permitted**. -You can find detailed information about the Appcircle organizational structure in the documentation [**here**](https://docs.appcircle.io/account/my-organization). +You can find detailed information about the Appcircle organizational structure in the documentation [**here**](/account/my-organization). ::: diff --git a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md index 4afb403f2..a52ec8b34 100644 --- a/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md +++ b/docs/workflows/common-workflow-steps/build-cache/how-to-share-file-between-pipelines.md @@ -26,7 +26,7 @@ As an example, **master** and **development** branches were used, but you can ap Please note that the organizational structure of Appcircle is designed in such a way as to prevent any **security vulnerabilities**. Consequently, exchanging files between organizations or sub-organizations **is not permitted**. -You can find detailed information about the Appcircle organizational structure in the documentation [**here**](https://docs.appcircle.io/account/my-organization). +You can find detailed information about the Appcircle organizational structure in the documentation [**here**](/account/my-organization). ::: @@ -36,7 +36,7 @@ In order to share cache between pipelines, the [**Cache Pull**](/workflows/commo ::: -1. To start, cache the CocoaPods files in the **development** branch, which will later be utilized in the **master** branch. For this purpose, add the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) step to the workflow after the [**CocoaPods Install**](https://docs.appcircle.io/workflows/ios-specific-workflow-steps/cocoapods-install) step. +1. To start, cache the CocoaPods files in the **development** branch, which will later be utilized in the **master** branch. For this purpose, add the [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) step to the workflow after the [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) step. diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md index bfc8842a6..e6581fa2a 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md @@ -8,7 +8,7 @@ import Screenshot from '@site/src/components/Screenshot'; # Flutter Install -This workflow step installs the specified [**Flutter SDK**](https://docs.flutter.dev/get-started/install) to run the [**Flutter CLI**](https://docs.flutter.dev/reference/flutter-cli) for subsequent analysis, build, and test operations. The Flutter version can be specified in [Configuration](https://docs.appcircle.io/build/building-flutter-applications/#build-configuration-for-flutter-applications). +This workflow step installs the specified [**Flutter SDK**](https://docs.flutter.dev/get-started/install) to run the [**Flutter CLI**](https://docs.flutter.dev/reference/flutter-cli) for subsequent analysis, build, and test operations. The Flutter version can be specified in [Configuration](/build/platform-build-guides/building-flutter-applications#build-configuration-for-flutter-ios-applications) :::info diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md index 5a18ef6db..125ccfbf6 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md @@ -8,7 +8,7 @@ import Screenshot from '@site/src/components/Screenshot'; # Cocoapods Install -Runs the [CocoaPods](https://cocoapods.org) install command for dependency management. This step installs all pod dependencies. Appcircle uses the `pod install` command to install pods in the project. This command comes from the CocoaPods tool installed on the system. If a version is not specified for CocoaPods, this step will use the version of [**CocoaPods installed**](https://docs.appcircle.io/infrastructure/ios-build-infrastructure#ios-build-agent-stacks) on the system. +Runs the [CocoaPods](https://cocoapods.org) install command for dependency management. This step installs all pod dependencies. Appcircle uses the `pod install` command to install pods in the project. This command comes from the CocoaPods tool installed on the system. If a version is not specified for CocoaPods, this step will use the version of [**CocoaPods installed**](/infrastructure/ios-build-infrastructure#ios-build-agent-stacks) on the system. ### Prerequisites diff --git a/docs/workflows/ios-specific-workflow-steps/index.md b/docs/workflows/ios-specific-workflow-steps/index.md index e2f0fc789..dab01cd9b 100644 --- a/docs/workflows/ios-specific-workflow-steps/index.md +++ b/docs/workflows/ios-specific-workflow-steps/index.md @@ -123,8 +123,7 @@ This step installs [SwiftLint](https://github.com/realm/SwiftLint/) and runs swi This component provides detailed reports and insights on the results of iOS app tests conducted. For detailed information on the usage of **Test Reports for iOS**, please refer to the documentation: - -[https://docs.appcircle.io/continuous-testing/running-ios-unit-and-ui-tests#generating-test-report](https://docs.appcircle.io/continuous-testing/running-ios-unit-and-ui-tests#generating-test-report) +- [Generating Test Report](/continuous-testing/ios-testing/running-ios-unit-and-ui-tests#generating-test-report) Test Reports for iOS diff --git a/docs/workflows/ios-specific-workflow-steps/xcode-select.md b/docs/workflows/ios-specific-workflow-steps/xcode-select.md index 79a7fc194..093f9b756 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcode-select.md +++ b/docs/workflows/ios-specific-workflow-steps/xcode-select.md @@ -8,7 +8,7 @@ import Screenshot from '@site/src/components/Screenshot'; # Xcode Select (Version) -This step is used to specify the Xcode version to be used during the build process. All available versions of Xcode can be seen in the [Configuration](https://docs.appcircle.io/build/build-process-management/build-profile-configuration) tab. +This step is used to specify the Xcode version to be used during the build process. All available versions of Xcode can be seen in the [Configuration](/build/build-process-management/build-profile-configuration) tab. ### Prerequisites diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md index 6f70aeee8..7417a435d 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md @@ -35,7 +35,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|----------------------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps#git-clone) step. | Required | | `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: **`-quiet`** | Optional | | `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. This variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md index bec0d5d4a..a97ba0a33 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-ui-test.md @@ -83,7 +83,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps#git-clone) step. | Required | | `$AC_OUTPUT_DIR` | This variable specifies the path of the artifacts that will be generated after the build is complete. | Required | | `$AC_RN_DETOX_CONFIGURATION` | Specify the detox configuration name to used when building and running the tests. | Required | | `$AC_RN_DETOX_TEST_ARGS` | Specify the Detox extra arguments to add the test command. The arguments will be executed by appending `detox test --configuration` to the end of the command. The default value is `--take-screenshots all` For more information, see the Detox test [CLI options](https://wix.github.io/Detox/docs/19.x/api/detox-cli/#test). | Optional | diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md index e11943d96..cff4e357c 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md @@ -42,7 +42,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](https://docs.appcircle.io/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps#git-clone) step. | Required | | `$AC_OUTPUT_DIR` | This variable specifies the path of the artifacts that will be generated after the build is complete. | Required | | `$AC_RN_TEST_COMMAND_ARGS` | Specify additional command arguments for running Jest tests. An extra parameter will be added to the end of the command `jest`. You can add extra arguments, such as `--debug --colors`, without affecting the default ones. For more information, see the Jest [CLI options](https://jestjs.io/docs/cli#options). | Optional | From 76fab7e2b79237ee24d5086bbe1551599a9f84a8 Mon Sep 17 00:00:00 2001 From: boztopuz Date: Mon, 2 Dec 2024 18:40:26 +0300 Subject: [PATCH 09/10] [BE-4789]: All feedback fixed --- .../android-build-for-ui-testing.md | 2 +- .../android-build.md | 4 +-- .../android-dependency-report.md | 4 +-- .../android-unit-tests.md | 4 +-- .../app-center-android-distribution.md | 3 ++- .../appdome-build-to-secure-for-android.md | 2 +- .../appsweep-mobile-security-testing.md | 2 +- .../azure-bot-for-detekt-report.md | 2 +- .../browserstack-app-automate-espresso.md | 2 +- .../bundle-universal-apk.md | 2 +- .../firebase-test-lab.md | 8 ++++++ .../gradle-runner.md | 2 +- .../android-specific-workflow-steps/lint.md | 3 ++- .../active-ssh-private-key.md | 2 ++ .../add-badge-app-icon.md | 2 +- .../common-workflow-steps/appium-server.md | 4 +-- .../aws-device-farm-and-deploy.md | 4 +-- .../common-workflow-steps/azure-board.md | 4 +-- .../build-cache/cache-pull.md | 2 ++ .../build-cache/cache-push.md | 2 +- .../common-workflow-steps/custom-script.md | 4 +-- .../workflows/common-workflow-steps/danger.md | 8 +++--- .../common-workflow-steps/fastlane.md | 6 ++--- .../firebase-app-distribution.md | 6 +++++ .../fod-mobile-assesment.md | 2 +- .../common-workflow-steps/jira-comment.md | 2 +- .../maestro-cloud-upload.md | 6 +++++ .../common-workflow-steps/marathon-cloud.md | 2 ++ .../publish-release-notes.md | 2 +- .../repeato-test-runner.md | 4 ++- .../set-environment-variable.md | 8 +++++- .../common-workflow-steps/sonarqube.md | 5 +++- .../firebase-deployment.md | 4 +-- .../flutter-analyze.md | 6 +++-- .../flutter-build-for-android.md | 2 +- .../flutter-build-for-ios.md | 6 ++--- .../flutter-build-for-web.md | 2 +- .../flutter-install.md | 2 +- .../flutter-test.md | 2 +- .../appcenter-ios-distribution.md | 4 +-- .../appdome-build-to-secure-for-ios.md | 9 ++++--- .../audit-permission-change.md | 6 ++--- .../azure-bot-for-swiftlint.md | 4 +-- .../ios-specific-workflow-steps/carthage.md | 9 +++---- .../cocoapods-deintegrate.md | 4 +-- .../cocoapods-install.md | 6 ++--- .../convert-xcresult-to-xml-html.md | 4 +-- .../install-certificates-provisions.md | 4 +-- .../ios-increment-build-and-version-number.md | 4 +-- .../ios-specific-workflow-steps/slather.md | 4 +-- .../ios-specific-workflow-steps/swiftlint.md | 14 +++++----- .../tuist-commands.md | 8 +++--- .../tuist-install.md | 8 +++--- .../xcode-select.md | 6 ++--- .../xcodebuild-for-devices.md | 26 +++++++++---------- .../xcodebuild-for-ios-simulator.md | 8 +++--- .../xcodebuild-for-testing.md | 2 +- .../xcodebuild-for-unit-and-ui-test.md | 10 +++---- .../app-center-code-push.md | 6 ++--- .../node-install.md | 4 +-- .../npm-yarn-commands.md | 4 +-- .../react-native-unit-test.md | 2 +- 62 files changed, 168 insertions(+), 127 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md index 216348589..eb5f7f692 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md +++ b/docs/workflows/android-specific-workflow-steps/android-build-for-ui-testing.md @@ -1,7 +1,7 @@ --- title: Android Build for UI Testing description: Learn how to use the Android Build for UI Testing workflow step in Appcircle -tags: [android, mobile, android, ui testing, testing] +tags: [android, mobile, ui testing, testing] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/android-specific-workflow-steps/android-build.md b/docs/workflows/android-specific-workflow-steps/android-build.md index 9e19bdb9e..ebb01a533 100644 --- a/docs/workflows/android-specific-workflow-steps/android-build.md +++ b/docs/workflows/android-specific-workflow-steps/android-build.md @@ -1,7 +1,7 @@ --- title: Android Build description: Learn how to use the Android Build workflow step in Appcircle -tags: [android, mobile, android, build] +tags: [android, mobile, android build, build] --- import Screenshot from '@site/src/components/Screenshot'; @@ -16,7 +16,7 @@ Before running the **Android Build** step, you must complete certain prerequisit | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Git Clone](/workflows/common-workflow-steps/git-clone) | To initiate the Android build process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the Git Clone step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the Android build process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the Git Clone step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | diff --git a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md index c73dad54d..ad5698fd1 100644 --- a/docs/workflows/android-specific-workflow-steps/android-dependency-report.md +++ b/docs/workflows/android-specific-workflow-steps/android-dependency-report.md @@ -1,7 +1,7 @@ --- title: Android Dependency Report description: Learn how to use the Android Dependency Report workflow step in Appcircle -tags: [android, mobile, android, report] +tags: [android, mobile, dependency, report] --- import Screenshot from '@site/src/components/Screenshot'; @@ -45,7 +45,7 @@ The output(s) resulting from the operation of this component are as follows: :::danger -If you wish to review or download the Android Dependencies Report, you can find them directly from [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). To do this, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step follows the **Android Dependency Report** workflow step. +If you wish to review or download the **Android Dependencies Report**, you can find them directly from [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts). To do this, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step follows the **Android Dependency Report** workflow step. diff --git a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md index 17c892b85..b3512fae7 100644 --- a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md +++ b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md @@ -1,7 +1,7 @@ --- title: Android Unit Tests description: Learn how to use the Android Unit Tests workflow step in Appcircle -tags: [android, mobile, android, testing] +tags: [android, mobile, unit, testing] --- import Screenshot from '@site/src/components/Screenshot'; @@ -18,7 +18,7 @@ Before running the **Android Unit Tests** step, you must complete certain prereq | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Android Unit Tests** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Unit Tests** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Android Unit Tests** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Unit Tests** step. | diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index 1f42bb27e..d1abf7dc0 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -1,7 +1,7 @@ --- title: App Center Android Distribute description: App Center Android Distribute enables developers to distribute their Android applications to testers and stakeholders for testing purposes. -tags: [android, mobile, distribution] +tags: [android, mobile, distribution, app center] --- import Screenshot from '@site/src/components/Screenshot'; @@ -13,6 +13,7 @@ import Screenshot from '@site/src/components/Screenshot'; The Appcircle **App Center Android Distribute** step allows you to seamlessly distribute your Android applications and mapping files to [App Center](https://appcenter.ms). :::caution + Please note that you can also distribute your app via Appcircle. Utilizing Appcircle's distribution modules enhances manageability within the platform. For more details, please refer to the following links: diff --git a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md index a956731dd..821262858 100644 --- a/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md +++ b/docs/workflows/android-specific-workflow-steps/appdome-build-to-secure-for-android.md @@ -1,7 +1,7 @@ --- title: Appdome Build-2Secure for Android description: Appdome Build-2Secure automates the integration of advanced security features, adaptive protections, code-signing, and certification processes into mobile applications, enhancing security without the need for manual coding or code analysis. -tags: [android, mobile, security, appdome] +tags: [android, mobile, security, build, appdome] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index c6975e2be..e26ac71ff 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -1,7 +1,7 @@ --- title: AppSweep Mobile Security Testing description: Learn how to use the AppSweep Mobile Security Testing workflow step in Appcircle -tags: [android, mobile, android, security, testing, app sweep] +tags: [android, mobile, android, security, testing, appsweep] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md index 5c7c4a6e3..83fb8abe7 100644 --- a/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md +++ b/docs/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report.md @@ -1,7 +1,7 @@ --- title: Azure DevOps Bot for Detekt Report description: The Azure DevOps Bot for Detekt Report step analyze your Detekt report and post the report details within the opened pull request in Azure DevOps. -tags: [detekt report, analysis] +tags: [detekt, report, azure devops, bot, analysis] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md index 76e2e297c..890cd2b59 100644 --- a/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md +++ b/docs/workflows/android-specific-workflow-steps/browserstack-app-automate-espresso.md @@ -1,7 +1,7 @@ --- title: BrowserStack App Automate - Espresso description: BrowserStack App Automate - Espresso is a testing solution provided by BrowserStack specifically designed for Android applications using the Espresso testing framework. -tags: [android, mobile, testing, browserstack] +tags: [android, mobile, testing, espresso, browserstack] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md index 64da4b05e..a4ebd0ed4 100644 --- a/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md +++ b/docs/workflows/android-specific-workflow-steps/bundle-universal-apk.md @@ -1,7 +1,7 @@ --- title: Bundle Universal Apk description: This step creates a universal APK from an AAB file. -tags: [android, mobile, distribution] +tags: [android, mobile, distribution, bundle, aab, apk] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md index 8d7753d1b..c621c98e2 100644 --- a/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md +++ b/docs/workflows/android-specific-workflow-steps/firebase-test-lab.md @@ -65,6 +65,14 @@ This step contains some input variable(s). It needs these variable(s) to work. T +:::danger Sensitive Variables + +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. + +We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. + +::: + | Variable Name | Description | Status | |---------------------------|----------------------------------------------------|----------| | `$AC_FIREBASE_PROJECT_ID` | Specifies the name of the Firebase project created. | Optional | diff --git a/docs/workflows/android-specific-workflow-steps/gradle-runner.md b/docs/workflows/android-specific-workflow-steps/gradle-runner.md index 22dc000f8..94729d229 100644 --- a/docs/workflows/android-specific-workflow-steps/gradle-runner.md +++ b/docs/workflows/android-specific-workflow-steps/gradle-runner.md @@ -16,7 +16,7 @@ Before running the **Gradle Runner** step, you must complete certain prerequisit | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Gradle Runner** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Gradle Runner** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To initiate the **Gradle Runner** process, the repository that needs to be built must be fetched from the branch. This is achieved as follows: Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Gradle Runner** step. | diff --git a/docs/workflows/android-specific-workflow-steps/lint.md b/docs/workflows/android-specific-workflow-steps/lint.md index 911f332c8..8d36cb01d 100644 --- a/docs/workflows/android-specific-workflow-steps/lint.md +++ b/docs/workflows/android-specific-workflow-steps/lint.md @@ -18,7 +18,7 @@ Before running the **Android Lint** step, you must complete certain prerequisite | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To start the **Android Lint** process, the repository that needs to be built must be fetched from the branch. This generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Lint** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | To start the **Android Lint** process, the repository that needs to be built must be fetched from the branch. This generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the **Android Lint** step. | :::caution @@ -42,6 +42,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. | Optional | :::info + If you have filled in the required variables in the **Configuration** section, you will not need to redefine these variables again on the [**Workflows**](/workflows/). For more information about configurations, refer to the [Build Profile Configuration Overview](/build/build-process-management/build-profile-configuration) document. diff --git a/docs/workflows/common-workflow-steps/active-ssh-private-key.md b/docs/workflows/common-workflow-steps/active-ssh-private-key.md index 5e30b07b9..66aab0e73 100644 --- a/docs/workflows/common-workflow-steps/active-ssh-private-key.md +++ b/docs/workflows/common-workflow-steps/active-ssh-private-key.md @@ -12,6 +12,8 @@ This step sets up your SSH key in the build machine if you used one to connect y ### Prerequisites +There are no prerequisites required before using the **Active SSH Private Key** step. + :::caution If you connect to your repository via SSH, use this step before the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. To securely clone repositories connected via SSH, you must define the SSH key for the relevant build agent. diff --git a/docs/workflows/common-workflow-steps/add-badge-app-icon.md b/docs/workflows/common-workflow-steps/add-badge-app-icon.md index b40640407..a92f86a8d 100644 --- a/docs/workflows/common-workflow-steps/add-badge-app-icon.md +++ b/docs/workflows/common-workflow-steps/add-badge-app-icon.md @@ -21,7 +21,7 @@ Before running the **Add a Badge to Your App Icon** step, you must complete cert | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps#git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](/workflows/common-workflow-steps#git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `$AC_REPOSITORY_DIR` will be set. | :::caution diff --git a/docs/workflows/common-workflow-steps/appium-server.md b/docs/workflows/common-workflow-steps/appium-server.md index 4bd3060c6..4f7d3dcd3 100644 --- a/docs/workflows/common-workflow-steps/appium-server.md +++ b/docs/workflows/common-workflow-steps/appium-server.md @@ -1,7 +1,7 @@ --- title: Appium Server description: Enhance your app testing with Appium Server. Automate mobile app testing across platforms for better efficiency and accuracy in development. -tags: [testing, automation, server, cli, development] +tags: [testing, automation, server, cli, development, appium] --- @@ -15,7 +15,7 @@ You can easily integrate the **Appium CLI** into your pipeline using Appcircle's ### Prerequisites -There are no prerequisites required before using the **Appium Server** step. You can place it anywhere within your pipeline according to your workflow needs. +There are no prerequisites required before using the **Appium Server** step. ### Input Variables diff --git a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md index 92277cea7..ba2a422f1 100644 --- a/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md +++ b/docs/workflows/common-workflow-steps/aws-device-farm-and-deploy.md @@ -1,7 +1,7 @@ --- title: AWS Device Farm and Deploy description: AWS Device Farm is an application testing service that enables you to run your tests concurrently on multiple mobile devices to speed up the execution of your tests and generates videos and logs to help you quickly identify issues with your app. -tags: [android, ios, mobile, testing, aws] +tags: [android, ios, mobile, testing, aws, device, farm] --- import Screenshot from '@site/src/components/Screenshot'; @@ -28,7 +28,7 @@ Pay attention to the dependent step on whichever platform you are working on. | Prerequisite Workflow Step | Description | | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | The Android Build for UI Testing workflow step is tailored to build your Android test application using Gradle Wrapper (gradlew) for the designated architectures outlined in your project. | +| [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | This step is tailored to build your Android test application using Gradle Wrapper (gradlew) for the designated architectures outlined in your project. | | [**Xcodebuild Build for Testing**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing) | This step builds your application and generates an IPA for testing so that it can be used in test automation frameworks. | #### For iOS diff --git a/docs/workflows/common-workflow-steps/azure-board.md b/docs/workflows/common-workflow-steps/azure-board.md index ff24f2865..9751fcb44 100644 --- a/docs/workflows/common-workflow-steps/azure-board.md +++ b/docs/workflows/common-workflow-steps/azure-board.md @@ -20,13 +20,13 @@ There are no prerequisites required before using the **Azure Boards** step. It d :::caution -Please note that once the Azure Boards component has run successfully, the status of the relevant article in your Azure Board account will be changed. If the build fails in Appcircle, an incorrect status may appear in your Azure Board account. Make sure you use it in the correct order in Workflow. +Please note that once the **Azure Boards** component has run successfully, the status of the relevant article in your Azure Board account will be changed. If the build fails in Appcircle, an incorrect status may appear in your Azure Board account. Make sure you use it in the correct order in Workflow. ::: ### Configuration of Component -To add a comment, the issue ID `AC_AZUREBOARD_WORKITEM` must be supplied to the component. We need to get this issue ID dynamically so that our workflow can work for multiple branches. Appcircle components use environment variables to pass the state. We can add a step just before the Azure Boards component to prepare the necessary environment variables. +To add a comment, the issue ID `$AC_AZUREBOARD_WORKITEM` must be supplied to the component. We need to get this issue ID dynamically so that our workflow can work for multiple branches. Appcircle components use environment variables to pass the state. We can add a step just before the Azure Boards component to prepare the necessary environment variables. Let's say you're working on a feature branch called feature/onboarding-1. You may use the below Ruby script to get issue ID 1 from the branch name and use this information with the Azure Boards component. Please see the [**Custom Script step documentation**](/workflows/common-workflow-steps/upload-files-to-amazon-s3) for this implementation. diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md index a84e24ca2..f9879d963 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-pull.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-pull.md @@ -11,7 +11,9 @@ import Screenshot from '@site/src/components/Screenshot'; [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) uploads the cache archive file to a remote location, as we explained in detail in the **Cache Push** step. On the other hand, **Cache Pull** downloads and extracts that archive file in the build pipeline, restoring all files and folders to their original locations. :::danger + [**Cache Push**](/workflows/common-workflow-steps/build-cache/cache-push) and **Cache Pull** components should work in coordination on the same cache file. Therefore, to download the pushed cache, the **Cache Pull** must have the same cache label as the **Cache Push**. + ::: :::info diff --git a/docs/workflows/common-workflow-steps/build-cache/cache-push.md b/docs/workflows/common-workflow-steps/build-cache/cache-push.md index e4c6d5366..b01146434 100644 --- a/docs/workflows/common-workflow-steps/build-cache/cache-push.md +++ b/docs/workflows/common-workflow-steps/build-cache/cache-push.md @@ -38,7 +38,7 @@ Before running the **Cache Push** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | If the folders to be cached are in the repo directory, the **Git Clone** step must be used before. This step will generate the [`AC_REPOSITORY_DIR`](#input-variables) path. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | If the folders to be cached are in the repo directory, the **Git Clone** step must be used before. This step will generate the [`$AC_REPOSITORY_DIR`](#input-variables) path. | :::danger diff --git a/docs/workflows/common-workflow-steps/custom-script.md b/docs/workflows/common-workflow-steps/custom-script.md index 5b63dd092..70bcd71fc 100644 --- a/docs/workflows/common-workflow-steps/custom-script.md +++ b/docs/workflows/common-workflow-steps/custom-script.md @@ -161,7 +161,7 @@ sed -i '' 's/old-value/new-value/g' build.gradle For each step in the workflow, you can view the input and output variables in the step configuration. -The repository directory is an output of the Git Clone step and its patch can be accessed with the `AC_REPOSITORY_PATH` environment variable by any step added after the Git Clone step. An example is as follows: +The repository directory is an output of the Git Clone step and its patch can be accessed with the `$AC_REPOSITORY_PATH` environment variable by any step added after the **Git Clone** step. An example is as follows: ```bash cd $AC_REPOSITORY_DIR @@ -170,7 +170,7 @@ cat README ### How to a add a file as a downloadable build artifact? -You can add any file to the output directory that contain the build artifacts using the `AC_OUTPUT_DIR` environment variable. An example is as follows: +You can add any file to the output directory that contain the build artifacts using the `$AC_OUTPUT_DIR` environment variable. An example is as follows: ```bash cd $AC_REPOSITORY_DIR/app/build/reports/ diff --git a/docs/workflows/common-workflow-steps/danger.md b/docs/workflows/common-workflow-steps/danger.md index d4ca8052a..1fc1919b2 100644 --- a/docs/workflows/common-workflow-steps/danger.md +++ b/docs/workflows/common-workflow-steps/danger.md @@ -1,7 +1,7 @@ --- title: Danger description: Streamline your code review process with Danger. Automate checks and enforce code standards pre-merge to maintain high-quality software. -tags: [code review, quality assurance, automaiton, development tools, appcircle, mobile ci/cd] +tags: [danger, code review, quality assurance, automaiton, development tools, appcircle, mobile ci/cd] --- @@ -19,7 +19,7 @@ https://appcircle.io/blog/danger-in-ci-automate-your-mobile-code-reviews :::danger -This tool does not support AzureDevOps. Therefore, if your repository is hosted on AzureDevOps, this tool will not function. Please use the [**Azure Bot for Swiftlint**](/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint)(for iOS) and [**Azure Bot for Detekt Report**](/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report)(for Android) components instead. +This tool does not support AzureDevOps. Therefore, if your repository is hosted on AzureDevOps, this tool will not function. Please use the [**Azure Bot for Swiftlint**](/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint)(for iOS) and [**Azure Bot for Detekt Report**](/workflows/android-specific-workflow-steps/azure-bot-for-detekt-report)(for Android) components instead. ::: @@ -29,7 +29,7 @@ Before running the **Danger** step, you must complete certain prerequisites, as | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the badge-adding process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the code review process. After this step, the variable `$AC_REPOSITORY_DIR` will be set. | :::caution @@ -55,7 +55,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | Variable Name | Description | Status | |-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|----------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_DANGER_PATH` | Specifies path of Dangerfile. This path comes from `$AC_REPOSITORY_DIR`. If DangerFile is in main directory of your repository. Do not change. | Required | | `$AC_DANGER_EXTRA_PARAMETERS` | Extra command line parameters. For Example: enter `--verbose` for verbose mode. | Optional | | `$DANGER_GITHUB_API_TOKEN` | Github Access Token for the bot user. | Optional | diff --git a/docs/workflows/common-workflow-steps/fastlane.md b/docs/workflows/common-workflow-steps/fastlane.md index 012072d3b..0a15811f9 100644 --- a/docs/workflows/common-workflow-steps/fastlane.md +++ b/docs/workflows/common-workflow-steps/fastlane.md @@ -18,7 +18,7 @@ Before running the **Fastlane** step, you must complete certain prerequisites, a | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the Fastlane process. After the clone, Fastlane will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the Fastlane process. After the clone, Fastlane will be installed. After this step works, the variable `$AC_REPOSITORY_DIR` will be created. | @@ -37,8 +37,8 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_FASTLANE_DIR` | This path is Fastlane's path in the project. By default, it is AC_REPOSITORY_DIR. If your Fastlane file is in a different location in the repo, please change it. | Required | -| `$AC_FASTLANE_LANE` | Fastlane lane. For example: `android deploy` or `ios release` | Required | +| `$AC_FASTLANE_DIR` | This path is Fastlane's path in the project. By default, it is `$AC_REPOSITORY_DIR`. If your Fastlane file is in a different location in the repo, please change it. | Required | +| `$AC_FASTLANE_LANE` | Fastlane lane. For example: `android deploy` or `ios release`. | Required | --- diff --git a/docs/workflows/common-workflow-steps/firebase-app-distribution.md b/docs/workflows/common-workflow-steps/firebase-app-distribution.md index 505893563..5c5759989 100644 --- a/docs/workflows/common-workflow-steps/firebase-app-distribution.md +++ b/docs/workflows/common-workflow-steps/firebase-app-distribution.md @@ -88,6 +88,12 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_FIREBASE_GROUPS` | Specifies the Firebase tester groups you want to invite. | Optional | | `$AC_FIREBASE_EXTRA_PARAMETERS` | Specifies extra command line parameters. Enter `--debug` for debug mode. | Optional | +:::info Output Variables + +The **Firebase App Distribution** step generates no output variables. The step succeeds if the app is distributed successfully; otherwise, it fails. + +::: + --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md index 2fa221231..d80d10f2a 100644 --- a/docs/workflows/common-workflow-steps/fod-mobile-assesment.md +++ b/docs/workflows/common-workflow-steps/fod-mobile-assesment.md @@ -1,7 +1,7 @@ --- title: Fortify on Demand Mobile Assessment description: Optimize mobile app security with Fortify on Demand Mobile Assessment. Comprehensive testing for robust, secure mobile applications. -tags: [mobile, mobile ci/cd, security, integration, ios, android] +tags: [fortify, demand, mobile ci/cd, security, integration, ios, android] --- diff --git a/docs/workflows/common-workflow-steps/jira-comment.md b/docs/workflows/common-workflow-steps/jira-comment.md index c06ef0aa0..a7aef7660 100644 --- a/docs/workflows/common-workflow-steps/jira-comment.md +++ b/docs/workflows/common-workflow-steps/jira-comment.md @@ -100,7 +100,7 @@ The required inputs for authorization vary based on the type of Jira instance (O | `$AC_JIRA_EMAIL` | The email associated with your Jira account. This field is required for using API tokens instead of PAT. | Optional | | `$AC_JIRA_TOKEN` | User's API Token. If this value is fill, the Jira e-mail field must be filled. Only Jira Cloud users can use API Token. You can create token from [here](https://id.atlassian.com/manage-profile/security/api-tokens) | Optional | | `$AC_JIRA_PAT` | Specify the Personal Access Token for Jira authentication. Only Jira On-Prem users can use PAT. | Optional | -| `$AC_JIRA_ISSUE` | The ID or key of the issue. Refer to the [documentation](/workflows/common-workflow-steps/jira-comment) for instructions on extracting this information from branch names or commit messages. | Required | +| `$AC_JIRA_ISSUE` | The ID or key of the issue. Refer to this [header](/workflows/common-workflow-steps/jira-comment#configuration-of-jira-comment) for instructions on extracting this information from branch names or commit messages. | Required | | `$AC_JIRA_FAIL_TRANSITION` | Transition ID or name for the failed step. Optionally change the status of your issue if the previous state fails. Ensure that the `Always run this step even if the previous steps fail` switch is enabled for this feature to work. | Optional | | `$AC_JIRA_SUCCESS_TRANSITION` | Transition ID or name for the successful step. Optionally change the status of your issue if the previous state succeeds. | Optional | | `$AC_JIRA_TEMPLATE_V2` | The comment template used to post a comment if [Jira REST API Version 2](#jira-rest-api-version-reference) is selected. Variables prefixed with `$` will be replaced during the build process. Refer to [this header](#changing-template) to modify the template. | Required | diff --git a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md index 72febe114..f4ace693c 100644 --- a/docs/workflows/common-workflow-steps/maestro-cloud-upload.md +++ b/docs/workflows/common-workflow-steps/maestro-cloud-upload.md @@ -91,6 +91,12 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_MAESTRO_PULL_ID` | The ID of the pull request from which the upload originated. | Optional | | `$AC_MAESTRO_CLI_VERSION` | The version of the Maestro CLI is to be downloaded in your CI environment. The default value is the `latest` version. | Optional | +:::info Output Variables + +The **Maestro Cloud Upload** step generates no output variables. The results are shown in the build log. + +::: + --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/marathon-cloud.md b/docs/workflows/common-workflow-steps/marathon-cloud.md index 815cc685b..40b0c39bf 100644 --- a/docs/workflows/common-workflow-steps/marathon-cloud.md +++ b/docs/workflows/common-workflow-steps/marathon-cloud.md @@ -29,9 +29,11 @@ Please note that this component works separately on both the native **Android** | [**Android Build for UI Testing**](/workflows/android-specific-workflow-steps/android-build-for-ui-testing) | Once the Android Build for UI Testing step is completed, the test APK paths `$AC_APK_PATH` and `$AC_TEST_APK_PATH` are automatically generated. The **Marathon Cloud** component relies on these paths. | :::danger + When using this component for the **iOS platform**, do not forget to change the **`Destination`** value in the **Xcodebuild for Testing** step. This value will be `generic/platform=iOS` by default. This means that it creates a generic test `IPA` for all iOS devices. Since the Marathon Cloud component runs on a specific test device, you need to change this value. For example, `platform=iOS Simulator,name=iPhone 15 Pro,OS=17.2`. Please note that if you do not change this parameter, the Marathon Cloud component will fail and the pipeline will break. For further information, please follow the [**Xcodebuild for Testing documentation**](/workflows/ios-specific-workflow-steps/xcodebuild-for-testing). + ::: #### For Android diff --git a/docs/workflows/common-workflow-steps/publish-release-notes.md b/docs/workflows/common-workflow-steps/publish-release-notes.md index f1d786c7a..60228e6a8 100644 --- a/docs/workflows/common-workflow-steps/publish-release-notes.md +++ b/docs/workflows/common-workflow-steps/publish-release-notes.md @@ -59,4 +59,4 @@ Don't forget to use the [**Export Build Artifacts**](/workflows/common-workflow- To access the source code of this component, please use the following link: -https://github.com/appcircleio/appcircle-flutter-web-build-component +https://github.com/appcircleio/appcircle-release-notes-component diff --git a/docs/workflows/common-workflow-steps/repeato-test-runner.md b/docs/workflows/common-workflow-steps/repeato-test-runner.md index e668cfc35..1197aa1f5 100644 --- a/docs/workflows/common-workflow-steps/repeato-test-runner.md +++ b/docs/workflows/common-workflow-steps/repeato-test-runner.md @@ -22,14 +22,16 @@ Before running the **Repeato Test Runner** step, you must complete certain prere | Prerequisite Workflow Step | Description | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](/workflows/common-workflow-steps/#git-clone) | The repository that needs to be built must be fetched from the branch. Upon completion of the **Git Clone** step, it generates the `AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | +| [**Git Clone**](/workflows/common-workflow-steps/#git-clone) | The repository that needs to be built must be fetched from the branch. Upon completion of the **Git Clone** step, it generates the `$AC_REPOSITORY_DIR` variable, which is then used as the input for the Android Build step. | :::danger + If you wish to view the test results on Appcircle's Test Reports page, it is essential to use the [Test Reports](https://github.com/appcircleio/appcircle-test-report-component) step after the **Repeato Test Runner**. Please check out this document for more information: [Generating Test Report](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) + ::: ### Input Variables diff --git a/docs/workflows/common-workflow-steps/set-environment-variable.md b/docs/workflows/common-workflow-steps/set-environment-variable.md index bf5e6d664..d26c4f511 100644 --- a/docs/workflows/common-workflow-steps/set-environment-variable.md +++ b/docs/workflows/common-workflow-steps/set-environment-variable.md @@ -1,7 +1,7 @@ --- title: Set Environment Variable description: Set Environment Variable step sets environment value for given keys -tags: [environment, variable] +tags: [set, environment, variable] --- import Screenshot from '@site/src/components/Screenshot'; @@ -40,6 +40,12 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_SETENV_KEYS` | Specifies the key of the environment variable to be set. This should be a space-separated list of environment variable keys. | Required | | `$AC_SETENV_VALUE` | Specifies the value of the environment variable to set. If this field is left blank, the environment variable will be set to `null`. | Optional | +:::info Output Variables + +The **Set Environment Variable** step generates no output variables. Success or failure of this step depends on whether the environment variable is set correctly, allowing subsequent use within the workflow. + +::: + --- To access the source code of this component, please use the following link: diff --git a/docs/workflows/common-workflow-steps/sonarqube.md b/docs/workflows/common-workflow-steps/sonarqube.md index 2c4a0b279..22b48fe0f 100644 --- a/docs/workflows/common-workflow-steps/sonarqube.md +++ b/docs/workflows/common-workflow-steps/sonarqube.md @@ -18,7 +18,7 @@ Before running the **SonarQube** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | If you intend to retrieve the **SonarQube Scanner** parameters from the `sonar-project.properties` file in your repository, it's essential to employ the **Git Clone** step before the **SonarQube** step. After the **Git Clone** step is completed, it generates the `AC_REPOSITORY_DIR` variable, which is used as input for the **SonarQube** step. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | If you intend to retrieve the **SonarQube Scanner** parameters from the `sonar-project.properties` file in your repository, it's essential to employ the **Git Clone** step before the **SonarQube** step. After the **Git Clone** step is completed, it generates the `$AC_REPOSITORY_DIR` variable, which is used as input for the **SonarQube** step. | ### Input Variables @@ -39,6 +39,7 @@ Please note that **SonarQube** is a commercial code quality analysis tool. The p | `$AC_SONAR_EXTRA_PARAMETERS` | Extra command line parameters. Enter `-X` for debug mode. | Optional | ### Including Tests + You can also include your unit/UI test results in the **SonarQube** analysis. :::caution @@ -48,6 +49,7 @@ If you want to include your test results in the **SonarQube** analysis, always r ::: #### iOS Tests + :::danger @@ -57,6 +59,7 @@ SonarQube accepts `XML` format files to analyse test results. In order to analys ::: #### Android Tests + If you intend to send the test result file obtained from the Android unit test output to **SonarQube**, it is necessary to execute the **Android Unit Tests** step before the **SonarQube** step. diff --git a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md index f0bb695a3..a2406e356 100644 --- a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md +++ b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md @@ -29,9 +29,9 @@ This step contains some input variable(s). It needs these variable(s) to work. T -:::danger +:::danger Sensitive Variables -Avoid hard-coding sensitive information like tokens and API keys directly into the step parameters. +Please do not use sensitive variables such as **Username**, **Password**, **API Key**, or **Personal Access Key** directly within the step. We recommend using [**Environment Variables**](/environment-variables/managing-variables) groups for such sensitive variables. diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md index 87c78de78..af973dfaa 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-analyze.md @@ -1,7 +1,7 @@ --- title: Flutter Analyze description: This component runs the `flutter analyze` command in your Flutter project. -tags: [flutter, build, test, workflow, step] +tags: [flutter, analyze, build, test, workflow, step] --- import Screenshot from '@site/src/components/Screenshot'; @@ -35,9 +35,11 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_FLUTTER_PROJECT_DIR` | This parameter is used as the repository path. This path is created immediately after the Git Clone step. If the Git Clone step is not used, this path cannot be found. | Required| +| `$AC_FLUTTER_PROJECT_DIR` | This parameter is used as the repository path. This path is created immediately after the **Git Clone** step. If the **Git Clone** step is not used, this path cannot be found. | Required | | `$AC_FLUTTER_ANALYZE_EXTRA_ARGS` | You can use this parameter if you want to add an extra parameter to the build command line. | Optional | +--- + To access the source code of this component, please use the following link: https://github.com/appcircleio/appcircle-flutter-analyze-component diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md index 6cb3f51a8..fb560d785 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-android.md @@ -35,7 +35,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::info -If the required variables are already defined in the **Configuration** section, there is no need to redefine them in the Workflow. For more details, see the [Build Profile Configuration Overview](/build/build-process-management/build-profile-configuration). The details you provide in the configuration will serve as input for the Android Build step. Kindly substitute the example information with your details: +If the required variables are already defined in the **Configuration** section, there is no need to redefine them in the Workflow. For more details, see the [Build Profile Configuration Overview](/build/build-process-management/build-profile-configuration). The details you provide in the configuration will serve as input for the **Android Build** step. Kindly substitute the example information with your details: diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md index 8186389d7..b057941e5 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-ios.md @@ -1,7 +1,7 @@ --- title: Flutter Build for iOS description: Learn to build iOS apps with the Flutter Build for iOS component. Ensure Flutter Install and Git Clone steps are completed first. -tags: [flutter, build, test, workflow, step] +tags: [flutter, build, ios] --- import Screenshot from '@site/src/components/Screenshot'; @@ -29,7 +29,7 @@ Once you have compiled your app for Flutter iOS, the native environment will be :::danger -**Keep in mind** that this step is dependent on the Flutter Install step. If Flutter is not installed on the system, it will give a Flutter SDK not found error. +**Keep in mind** that this step is dependent on the **Flutter Install** step. If Flutter is not installed on the system, it will give a Flutter SDK not found error. ::: @@ -41,7 +41,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_FLUTTER_PROJECT_PATH` | This parameter is used as the repository path. This path is created immediately after the Git Clone step. If the Git Clone step is not used, this path cannot be found. | Required| +| `$AC_FLUTTER_PROJECT_PATH` | This parameter is used as the repository path. This path is created immediately after the **Git Clone** step. If the **Git Clone** step is not used, this path cannot be found. | Required | | `$AC_FLUTTER_BUILD_MODE` | With this variable, you can add the mode you want to build in the build command. For example: `release`. | Required | | `$AC_FLUTTER_BUILD_EXTRA_ARGS`| You can use this parameter if you want to add an extra parameter to the build command line. | Optional | diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md index 07566226c..1a9ea8d27 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-build-for-web.md @@ -1,7 +1,7 @@ --- title: ​Flutter Build for Web description: Learn to build web apps with the Flutter Build for Web component. Ensure Flutter Install and Git Clone steps are completed first. -tags: [flutter, build, test, workflow, step] +tags: [flutter, build, web] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md index e6581fa2a..bab024fe8 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-install.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-install.md @@ -1,7 +1,7 @@ --- title: Flutter Install description: This workflow step installs the specified Flutter SDK to run the Flutter CLI for subsequent analysis, build, and test operations. -tags: [flutter, build, test, workflow, step] +tags: [flutter, install, sdk] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md index 9aade193c..ecf1b8bb7 100644 --- a/docs/workflows/flutter-specific-workflow-steps/flutter-test.md +++ b/docs/workflows/flutter-specific-workflow-steps/flutter-test.md @@ -1,7 +1,7 @@ --- title: Flutter Test description: This component allows you to run Flutter unit tests. -tags: [flutter, build, test, workflow, step] +tags: [flutter, test, unit] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md index d791b9cd4..b453fb5e1 100644 --- a/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md +++ b/docs/workflows/ios-specific-workflow-steps/appcenter-ios-distribution.md @@ -1,7 +1,7 @@ --- title: App Center iOS Distribution description: Distribute your iOS app to App Center for testing and distribution. -tags: [build, test, distribute, app center, ios, workflow, step] +tags: [distribute, app center, ios, workflow, step] --- import Screenshot from '@site/src/components/Screenshot'; @@ -60,4 +60,4 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v To access the source code of this component, please use the following link: -[https://github.com/appcircleio/appcircle-ios-appcenter-distribute-component](https://github.com/appcircleio/appcircle-ios-appcenter-distribute-component) \ No newline at end of file +https://github.com/appcircleio/appcircle-ios-appcenter-distribute-component \ No newline at end of file diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index 1f4f80477..a97532988 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -62,17 +62,18 @@ The output(s) resulting from the operation of this component are as follows: :::caution -To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your workflow after this step. ::: | Variable Name | Description | Status | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -------- | -| `AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured .ipa file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing` | Required | -| `AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | TLocal path of the .sh sign script file. Available when `Signing Method` set to `Auto-Dev-Signing` | Required | -| `AC_APPDOME_CERTIFICATE_PATH` | Local path of the Certified Secure Certificate `.pdf` file | Required | +| `AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured `.ipa` file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing` | Required | +| `AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | TLocal path of the `.sh` sign script file. Available when `Signing Method` set to `Auto-Dev-Signing`. | Required | +| `AC_APPDOME_CERTIFICATE_PATH` | Local path of the Certified Secure Certificate `.pdf` file. | Required | --- To access the source code of this component, please use the following link: + https://github.com/appcircleio/appcircle-ios-appdome-component diff --git a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md index 9483f63e6..a912e9366 100644 --- a/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md +++ b/docs/workflows/ios-specific-workflow-steps/audit-permission-change.md @@ -1,7 +1,7 @@ --- title: Audit Permission Changes description: Track and audit permission changes effectively. Ensure security and compliance with our guide on monitoring access rights alterations. -tags: [cocoapods, install, workflow, step] +tags: [audit, permission, changes, workflow, step] --- import Screenshot from '@site/src/components/Screenshot'; @@ -18,7 +18,7 @@ Before running the **Audit Permission Changes** step, you must complete certain | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Audit Permission Changes process. After cloning, the system installs CocoaPods. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the **Audit Permission Changes** step. After cloning, the system installs CocoaPods. After this step works, the variable `$AC_REPOSITORY_DIR` will be created. | @@ -39,7 +39,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| | `$AC_REFERENCE_BRANCH` | Specifies the reference branch to check permissions. | Required | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj` | Required | --- diff --git a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md index 99726e6a9..ac67c7601 100644 --- a/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/azure-bot-for-swiftlint.md @@ -1,14 +1,14 @@ --- title: Azure Bot for Swiftlint description: Integrate Azure DevOps Bot with SwiftLint to analyze and report details under PRs. Automate builds with configured triggers. -tags: [ios, build, test, workflow, step] +tags: [ios, azure, bot, swiftlint, workflow, step] --- import Screenshot from '@site/src/components/Screenshot'; # Azure Bot for Swiftlint -With the Azure DevOps Bot for Swiftlint integration, you can analyze your [**SwiftLint**](https://github.com/realm/SwiftLint/) and post the report details under the opened PR. You can also modify the PR status. +With the **Azure DevOps Bot for Swiftlint** integration, you can analyze your [**SwiftLint**](https://github.com/realm/SwiftLint/) and post the report details under the opened PR. You can also modify the PR status. :::info diff --git a/docs/workflows/ios-specific-workflow-steps/carthage.md b/docs/workflows/ios-specific-workflow-steps/carthage.md index ad29e9471..6f80680b8 100644 --- a/docs/workflows/ios-specific-workflow-steps/carthage.md +++ b/docs/workflows/ios-specific-workflow-steps/carthage.md @@ -16,7 +16,6 @@ import Screenshot from '@site/src/components/Screenshot'; Before running the **Carthage** step, you must complete certain prerequisites, as detailed in the table below: - | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| | [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step clones your git repo on the runner where the build process will take place so that the necessary workflow operations can be performed. | @@ -37,10 +36,10 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_CARTHAGE_COMMAND` | Specifies the Carthage command to run. Defaults to `bootstrap`. **Possible values:** `bootstrap`, `update` | Required | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after [Git Clone](/workflows/common-workflow-steps/git-clone).| Optional | -| `$AC_CARTFILE_PATH` | Specifies the path where the Cartfile resides. Defaults to the repository directory. **DO NOT** include Cartfile, this is only the path. **This value will be appended** to `$AC_REPOSITORY_DIR`. **Example:** `./` or `./subpath-to-cartfile/` | Optional | -| `$AC_CARTHAGE_FLAGS` | Specifies additional flags after the Carthage command. The default value is empty. **For Xcode 12 and above, make sure to include** `--use-xcframeworks` **here**. To shorten the build time, make sure to specify the platform: `--platform iOS`. Example usage: `--platform iOS --use-xcframeworks` | Optional | +| `$AC_CARTHAGE_COMMAND` | Specifies the Carthage command to run. Defaults to `bootstrap`. **Possible values:** `bootstrap`, `update`. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after [**Git Clone**](/workflows/common-workflow-steps/git-clone).| Optional | +| `$AC_CARTFILE_PATH` | Specifies the path where the Cartfile resides. Defaults to the repository directory. **DO NOT** include Cartfile, this is only the path. **This value will be appended** to `$AC_REPOSITORY_DIR`. **Example:** `./` or `./subpath-to-cartfile/`. | Optional | +| `$AC_CARTHAGE_FLAGS` | Specifies additional flags after the Carthage command. The default value is empty. **For Xcode 12 and above, make sure to include** `--use-xcframeworks` **here**. To shorten the build time, make sure to specify the platform: `--platform iOS`. Example usage: `--platform iOS --use-xcframeworks`. | Optional | --- diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md index b62edd005..877b7044a 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-deintegrate.md @@ -18,7 +18,7 @@ Before running the **CocoaPods Deintegrate** step, you must complete certain pre | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods Deintegrate process. After the clone, Fastlane will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created.| +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods Deintegrate process. After the clone, Fastlane will be installed. After this step works, the variable `$AC_REPOSITORY_DIR` will be created.| :::caution @@ -37,7 +37,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| | `$AC_XCODEPROJ_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. Empty value will look for an `.xcodeproj` file. | Optional | -| `$AC_REPOSITORY_DIR` | Specifies the directory where the repository is cloned. This path is generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Optional | +| `$AC_REPOSITORY_DIR` | Specifies the directory where the repository is cloned. This path is generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Optional | | `$AC_COCOAPODS_VERSION` | Specifies the CocoaPods version. If you need a specific version, provide it here as hardcoded, and the system will automatically install that version. | Optional | --- diff --git a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md index 125ccfbf6..5ec0e730a 100644 --- a/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md +++ b/docs/workflows/ios-specific-workflow-steps/cocoapods-install.md @@ -16,7 +16,7 @@ Before running the **Cocoapods Install** step, you must complete certain prerequ | Prerequisite Workflow Step | Description | | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed. After this step works, the variable `AC_REPOSITORY_DIR` will be created. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed. After this step works, the variable `$AC_REPOSITORY_DIR` will be created. | @@ -29,12 +29,12 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](/build/build-process-management/build-profile-configuration). | Required | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_COCOAPODS_VERSION` | Specifies the CocoaPods version. If there is a specific version you want to use, give it here as hardcoded, and the system will automatically install the given version. | Optional | :::info -Please note that the CocoaPods Install step uses the default system [**CocoaPods version**](/infrastructure/ios-build-infrastructure#ios-build-agent-stacks). If you want to use a specific version, please enter it hardcoded in the CocoaPods Version parameter in the step. +Please note that the **CocoaPods Install** step uses the default system [**CocoaPods version**](/infrastructure/ios-build-infrastructure#ios-build-agent-stacks). If you want to use a specific version, please enter it hardcoded in the CocoaPods Version parameter in the step. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md index 3480cf8ce..867ef8ce3 100644 --- a/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md +++ b/docs/workflows/ios-specific-workflow-steps/convert-xcresult-to-xml-html.md @@ -17,7 +17,7 @@ Before running the **Convert Xcresult to HTML/XML** step, you must complete cert | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) | This step allows you to run unit and UI tests on your project. After this step runs, the related path, `AC_TEST_RESULT_PATH` will be generated automatically. | +| [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) | This step allows you to run unit and UI tests on your project. After this step runs, the related path, `$AC_TEST_RESULT_PATH` will be generated automatically. | :::caution @@ -52,7 +52,7 @@ The output(s) resulting from the operation of this component are as follows: :::caution -To view the converted test reports on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the converted test reports on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your workflow after this step. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md index f5e26a91c..f0dd048d8 100644 --- a/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md +++ b/docs/workflows/ios-specific-workflow-steps/install-certificates-provisions.md @@ -1,7 +1,7 @@ --- title: Install Certificates and Provisioning Profiles description: Learn how to install certificates and provisioning profiles for iOS distribution in Appcircle. -tags: [build, test, distribute, ios, workflow, step] +tags: [ios, provision, certificate, install, keychain, profiles, signing] --- import Screenshot from '@site/src/components/Screenshot'; @@ -56,7 +56,7 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| | `AC_KEYCHAIN_PATH` | A path is created after the certificate is added to the current runner's keychain. | -| `AC_KEYCHAIN_PASSWORD` | After this certificate is added to the keychain, the password assigned to the keychain | +| `AC_KEYCHAIN_PASSWORD` | After this certificate is added to the keychain, the password assigned to the keychain. | --- diff --git a/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md b/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md index 2d8c15ebb..7fcd864ba 100644 --- a/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md +++ b/docs/workflows/ios-specific-workflow-steps/ios-increment-build-and-version-number.md @@ -1,14 +1,14 @@ --- title: iOS Increment Build and Version Number description: Learn how to increment the version code and version name of an iOS application in Appcircle -tags: [versioning, ios, build version, version code, version name] +tags: [versioning, ios, build version, version code, version name, increment] --- import Screenshot from '@site/src/components/Screenshot'; # iOS Increment Build and Version Number -The **iOS Increment Build and Version Number** step is controlled by **iOS Versioning**. For detailed information about this step, including [**Prerequisites**](/versioning/ios-version#enabling-version-management), [**Input Variables**](/versioning/ios-version#input-variables), and[**Output Variables**](/versioning/ios-version#output-values), please refer to the documentation below: +The **iOS Increment Build and Version Number** step is controlled by **iOS Versioning**. For detailed information about this step, including [**Prerequisites**](/versioning/ios-version#enabling-version-management), [**Input Variables**](/versioning/ios-version#input-variables), and [**Output Variables**](/versioning/ios-version#output-values), please refer to the documentation below: - [**Understanding iOS Versioning**](/versioning/ios-version) diff --git a/docs/workflows/ios-specific-workflow-steps/slather.md b/docs/workflows/ios-specific-workflow-steps/slather.md index 610d48e5c..21b3eb0bf 100644 --- a/docs/workflows/ios-specific-workflow-steps/slather.md +++ b/docs/workflows/ios-specific-workflow-steps/slather.md @@ -1,7 +1,7 @@ --- title: Slather description: Use Slather to convert Xcode's test results into various formats. Prerequisites include Xcodebuild for Tests and Git Clone. -tags: [ios, build, test, workflow, step] +tags: [ios, build, test, unit, ui, testing, step] --- import Screenshot from '@site/src/components/Screenshot'; @@ -16,7 +16,7 @@ Before running the **Slather** step, you must complete certain prerequisites, as | Prerequisite Workflow Step | Description | |------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your repository. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your repository. After this step works, the variable `$AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **Slather**. | | [**Xcodebuild for Unit and UI Tests**](/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test) | This step executes your unit and UI tests, generating a `.xcresult` file. This file serves as the mandatory test result input for **Slather**. | diff --git a/docs/workflows/ios-specific-workflow-steps/swiftlint.md b/docs/workflows/ios-specific-workflow-steps/swiftlint.md index 5ec9d2f87..44640a436 100644 --- a/docs/workflows/ios-specific-workflow-steps/swiftlint.md +++ b/docs/workflows/ios-specific-workflow-steps/swiftlint.md @@ -1,7 +1,7 @@ --- title: SwiftLint -description: Improve your code with SwiftLint, a tool for identifying programmatic and stylistic errors. Prerequisites include Git Clone and Cocoapods Install. -tags: [ios, build, test, workflow, step] +description: Improve your code with SwiftLint, a tool for identifying programmatic and stylistic errors. +tags: [ios, build, lint, error] --- import Screenshot from '@site/src/components/Screenshot'; @@ -15,14 +15,14 @@ Before running the **SwiftLint** step, you must complete certain prerequisites, | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repo needs to be cloned in order to start the CocoaPods installation process. After the clone, CocoaPods will be installed, and then SwiftLint will be run. After this step works, the variable `AC_REPOSITORY_DIR` will be created. This variable is the input variable for CocoaPods and SwiftLint. | -| [**Cocoapods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install)| This step will install the dependencies in the project before SwiftLint can run. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | This step will clone your repository. After this step works, the variable `$AC_REPOSITORY_DIR` will be created. This variable is the required input variable for **SwiftLint**. | +| [**Cocoapods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install)| This step will install the dependencies in the project before **SwiftLint** can run. | :::danger -If you are using **CocoaPods**, note that this step is dependent on the [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) step. Otherwise, the SwiftLint component will **fail**, and the **pipeline will break.** +If you are using **CocoaPods**, note that this step is dependent on the [**CocoaPods Install**](/workflows/ios-specific-workflow-steps/cocoapods-install) step. Otherwise, the **SwiftLint** component will **fail**, and the **pipeline will break.** ::: @@ -30,7 +30,7 @@ If you are using **CocoaPods**, note that this step is dependent on the [**Cocoa If you are using **Swift Package Manager (SPM)**, do not use this step. SPM packages will be compiled in other steps that work with **Xcode**, such as [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices). -If you have SPM in your project and you are using the SwiftLint component in your workflow, the Linter component will give an error because it cannot find the required dependencies. +If you have SPM in your project and you are using the **SwiftLint** component in your workflow, the Linter component will give an error because it cannot find the required dependencies. ::: @@ -56,7 +56,7 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `AC_LINT_OUTPUT_PATH` | The path of the SwfitLint results output file. After SwiftLint runs, all results will be written in a .txt file. It can be found in the download artifacts. | +| `AC_LINT_OUTPUT_PATH` | The path of the SwiftLint results output file. After **SwiftLint** runs, all results will be written in a `.txt` file. It can be found in the download artifacts. | --- diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md index 6dccb5675..7bae5b421 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-commands.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-commands.md @@ -18,8 +18,8 @@ Before running the **Tuist Commands** step, you must complete certain prerequisi | Prerequisite Workflow Step | Description | |---------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist Commands process. After cloning, it creates the `AC_REPOSITORY_DIR` variable, and the system is able to run the Tuist Commands. | -| [**Tuist Install**](/workflows/ios-specific-workflow-steps/tuist-install) | You need to install the Tuist to start the Tuist Commands process. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist Commands process. After cloning, it creates the `$AC_REPOSITORY_DIR` variable, and the system is able to run the **Tuist Commands**. | +| [**Tuist Install**](/workflows/ios-specific-workflow-steps/tuist-install) | You need to install the Tuist to start the **Tuist Commands** step. | :::caution Tuist Commands @@ -41,8 +41,8 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------| -| `$AC_TUIST_PATH` | Specifies the path to the directory containing the project definition. This path is automatically generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | -| `$AC_TUIST_COMMANDS` | Specifies the Tuist Commands to be able to run specific Tuist Commands. For example; `tuist test` or `tuist build`. | Required | +| `$AC_TUIST_PATH` | Specifies the path to the directory containing the project definition. This path is automatically generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_TUIST_COMMANDS` | Specifies the Tuist commands to be able to run specific Tuist commands. For example; `tuist test` or `tuist build`. | Required | --- diff --git a/docs/workflows/ios-specific-workflow-steps/tuist-install.md b/docs/workflows/ios-specific-workflow-steps/tuist-install.md index eba5dc6d4..09caed376 100644 --- a/docs/workflows/ios-specific-workflow-steps/tuist-install.md +++ b/docs/workflows/ios-specific-workflow-steps/tuist-install.md @@ -24,11 +24,11 @@ Before running the **Tuist Install** step, you must complete certain prerequisit | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist process. After cloning, the system installs Tuist and creates the `AC_REPOSITORY_DIR` variable. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | You need to clone the repository to start the Tuist process. After cloning, the system installs Tuist and creates the `$AC_REPOSITORY_DIR` variable. | :::caution Tuist Usage -Appcircle's Tuist Install component generates your project using only the `tuist generate` command. This means that it will automatically generate the `.xcworkspace` and `.xcodeproj` files in the project after the tuist generate command runs. Note that if you use Tuist Install in the Appcircle pipeline and want to generate an **IPA** file, you need the other build steps, such as +Appcircle's Tuist Install component generates your project using only the `tuist generate` command. This means that it will automatically generate the `.xcworkspace` and `.xcodeproj` files in the project after the tuist generate command runs. Note that if you use **Tuist Install** in the Appcircle pipeline and want to generate an **IPA** file, you need the other build steps, such as - [**Xcodebuild for Devices**](/workflows/ios-specific-workflow-steps/xcodebuild-for-devices) - [**Xcodebuild for iOS Simulator**](/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator) @@ -62,7 +62,7 @@ In some projects, the version of Tuist that needs to be installed and used can b :::caution Tuist Install -Appcircle uses homebrew as [installation method](https://docs.tuist.io/en/guides/quick-start/install-tuist) in Tuist Install step, therefore only compatible versions are supported. For more information, please check this [list](https://github.com/tuist/homebrew-tuist/tree/main/Formula) for compatible versions of Tuist. +Appcircle uses homebrew as [installation method](https://docs.tuist.io/en/guides/quick-start/install-tuist) in **Tuist Install** step, therefore only compatible versions are supported. For more information, please check this [list](https://github.com/tuist/homebrew-tuist/tree/main/Formula) for compatible versions of Tuist. For this reason, iOS apps using Tuist versions `1.x` or `2.x` are not supported with Appcircle's Tuist Components. @@ -70,7 +70,7 @@ For this reason, iOS apps using Tuist versions `1.x` or `2.x` are not supported | Variable Name | Description | Status | |--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------| -| `$AC_TUIST_PATH` | Specifies the path to the directory containing the project definition. This path is automatically generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_TUIST_PATH` | Specifies the path to the directory containing the project definition. This path is automatically generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_TUIST_VERSION` | Specifies the Tuist version. If not specified, the latest version of Tuist will be installed. | Optional | --- diff --git a/docs/workflows/ios-specific-workflow-steps/xcode-select.md b/docs/workflows/ios-specific-workflow-steps/xcode-select.md index 093f9b756..ffd201e0c 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcode-select.md +++ b/docs/workflows/ios-specific-workflow-steps/xcode-select.md @@ -1,7 +1,7 @@ --- title: Xcode Select -description: Specify Xcode version for your build process with Xcode Select. Always use before CocoaPods Install and Xcodebuild steps. -tags: [xcode, version, workflow, step] +description: Specify Xcode version for your build process with Xcode Select. +tags: [xcode, version, select, workflow, step] --- import Screenshot from '@site/src/components/Screenshot'; @@ -59,7 +59,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_XCODE_LIST_DIR` | Specifies the directory with the Xcode versions. Xcode versions are located under the /Volumes directory and selected according to the given version. | Required | +| `$AC_XCODE_LIST_DIR` | Specifies the directory with the Xcode versions. Xcode versions are located under the `/Volumes` directory and selected according to the given version. | Required | | `$AC_XCODE_VERSION` | Specifies the xcode version. This variable comes from Configuration. | Required | --- diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md index a88329fb9..dbe524127 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md @@ -28,7 +28,7 @@ Before running the **Xcodebuild for Devices** step, you must complete certain pr :::danger -This step should always follow steps that may affect Archive and Export, such as Xcode Select and Cocoapods Install. +This step should always follow steps that may affect Archive and Export, such as **Xcode Select** and **Cocoapods Install**. ::: @@ -41,15 +41,15 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_OUTPUT_DIR_PATH` | This variable specifies the path of the artifacts that will be generated after the build is complete. | Required | | `$AC_SCHEME` | Specifies the project scheme for build. If you filled in **`Configuration => Build Scheme`**, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | -| `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: -quiet | | +| `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: `-quiet` | | | `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_CERTIFICATES` | This variable specifies the path of the certificates to be signed. | Required | | `$AC_BUNDLE_IDENTIFIERS` | This variable holds the Bundle Identifier of the application to be built. | Required | | `$AC_PROVISIONING_PROFILES` | This variable specifies the path of provisioning profiles to be signed. | Required | -| `$AC_CONFIGURATION_NAME` | You can build your project with any configuration you want. Specify the configuration as hard coded. Appcircle will add automatically this configuration to the xcodebuild command. For example; **`Debug`** | Optional | +| `$AC_CONFIGURATION_NAME` | You can build your project with any configuration you want. Specify the configuration as hard coded. Appcircle will add automatically this configuration to the xcodebuild command. For example; **`Debug`**. | Optional | | `$AC_COMPILER_INDEX_STORE_ENABLE` | You can disable indexing during the build for faster build. Default value is `No`. | Optional | | `$AC_METHOD_FOR_EXPORT` | Describes how Xcode should export the archive. Available options are `auto-detect`, `app-store`, `ad-hoc`, `enterprise`, `development`. The default is `auto-detect`. | Optional | | `$AC_TEAMID_FOR_EXPORT` | The Developer Portal team to be use for this export. Defaults to the team used to build the archive. | Optional | @@ -65,9 +65,9 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | | --------------------------- | --------------------------------------------------------- | -| `$AC_ARCHIVE_PATH` | This is the path created after retrieving the archive. | -| `$AC_ARCHIVE_METADATA_PATH` | This is the path created after the metadata is generated. | -| `$AC_EXPORT_DIR` | This is the path created when exporting. | +| `AC_ARCHIVE_PATH` | This is the path created after retrieving the archive. | +| `AC_ARCHIVE_METADATA_PATH` | This is the path created after the metadata is generated. | +| `AC_EXPORT_DIR` | This is the path created when exporting. | --- @@ -81,19 +81,19 @@ https://github.com/appcircleio/appcircle-ios-build-sign-component ### Adding Additional Command to Xcodebuild for Devices Step -To address the need to add a new command after completing the `xcodebuild` command in the "Xcodebuild for Devices" step, you can follow the following approach: +To address the need to add a new command after completing the `xcodebuild` command in the **Xcodebuild for Devices** step, you can follow the following approach: -- Disable "Xcodebuild for Devices" step in your workflow. -- Add a new "Custom Script" component instead of "Xcodebuild for Devices" step. +- Disable **Xcodebuild for Devices** step in your workflow. +- Add a new "Custom Script" component instead of **Xcodebuild for Devices** step. - Go to Appcircle github profile and navigate to the [repository](https://github.com/appcircleio/appcircle-ios-build-sign-component). -- Copy all code lines from the `main.rb` file and paste them into the new "Custom Script" that you just added in your workflow. -- Change the name as "Custom Xcodebuild for Devices" for this custom script. +- Copy all code lines from the `main.rb` file and paste them into the new **Custom Script** that you just added in your workflow. +- Change the name as **Custom Xcodebuild for Devices** for this custom script. - Change "Execute With" picker as **Ruby**. - In the Ruby code, you can add the required codes to the end of the `xcodebuild` command. :::caution -Before running the script, some variables must be changed, and new variables must be added to the custom script. +Before running the script, some variables must be changed, and new variables must be added to the **custom script**. ::: diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md index ba1a6a1c0..462c5390a 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-ios-simulator.md @@ -36,12 +36,12 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_OUTPUT_DIR_PATH` | Specifies the path for outputs for generated artifacts. | Required | | `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_SIMULATOR_ARCH` | Specifies the CPU architecture for the simulator build. The default variable is **`arm64`**. | Optional | -| `$AC_SIMULATOR_NAME` | Destination name of the simulator. Ex. `iPhone 14`. If you set a simulator name, the build will be installed into the given simulator. Please be aware that setting the simulator name invalidates the `AC_SIMULATOR_ARCH` option. | Required | -| `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: -quiet | Optional | +| `$AC_SIMULATOR_NAME` | Destination name of the simulator. Ex. `iPhone 14`. If you set a simulator name, the build will be installed into the given simulator. Please be aware that setting the simulator name invalidates the `$AC_SIMULATOR_ARCH` option. | Required | +| `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: `-quiet`. | Optional | | `$AC_PROJECT_PATH` | Specifies the project path. If you filled in `Config => Xcode Project or Workspace Path` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). For example: `./appcircle.xcodeproj`. | Required | | `$AC_CONFIGURATION_NAME` | You can build your project with any configuration you want. Specify the configuration as hard coded. Appcircle will automatically add this configuration to the xcodebuild command. For example; **`Debug`**. | Optional | | `$AC_COMPILER_INDEX_STORE_ENABLE` | You can disable indexing during the build for a faster build. The default value is **`No`**. | Required | @@ -58,7 +58,7 @@ The output(s) resulting from the operation of this component are as follows: | Variable Name | Description | |-------------------------------|------------------------------------------------| -| `AC_SIMULATOR_APP_PATH` | Simulator app path. You can reach the Simulator app from this path, and it will be exported, it can be downloaded from the download artifacts. | +| `AC_SIMULATOR_APP_PATH` | Simulator app path. You can reach the simulator app from this path, and it will be exported, it can be downloaded from the **Download Artifacts**. | --- diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md index 7417a435d..2d498b852 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-testing.md @@ -35,7 +35,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|----------------------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps#git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps#git-clone) step. | Required | | `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: **`-quiet`** | Optional | | `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. This variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md index d34df7a43..d9d3e7a79 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-unit-and-ui-test.md @@ -1,7 +1,7 @@ --- title: Xcodebuild for Unit and UI Testing description: This step performs unit and UI tests for your iOS applications. This does not "build" your app, but uses the "xcodebuild" command to run tests. -tags: [build, test, ios, workflow, step] +tags: [build, test, ios, workflow, xcodebuild, unit, ui, testing] --- import Screenshot from '@site/src/components/Screenshot'; @@ -22,7 +22,7 @@ Before running the **Xcodebuild for Unit and UI Testing** step, you must complet | Prerequisite Workflow Step | Description | |-------------------------------------------------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository must be cloned to initiate the unit and UI testing process. Following the clone, this step will run the tests and create the `AC_REPOSITORY_DIR` variable. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository must be cloned to initiate the unit and UI testing process. Following the clone, this step will run the tests and create the `$AC_REPOSITORY_DIR` variable. | | [**Xcode Select**](/workflows/ios-specific-workflow-steps/xcode-select) | This step selects the specified Xcode version. | @@ -44,14 +44,14 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| -| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [Git Clone](/workflows/common-workflow-steps/git-clone) step. | Required | +| `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_OUTPUT_DIR_PATH` | Specifies the path for outputs for generated artifacts. | Required | | `$AC_SCHEME` | Specifies the project scheme for build. If you filled in `Config => Build Schema` in the Configuration, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: **`-quiet`** | Optional | | `$AC_PROJECT_PATH` | Specifies the project path. For example: **`./appcircle.xcodeproj`**. This variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Optional | | `$AC_CONFIGURATION_NAME` | You can build your project with any configuration you want. Specify the configuration as hard-coded. Appcircle will automatically add this configuration to the xcodebuild command. For example; **`Debug`** | Optional | | `$AC_COMPILER_INDEX_STORE_ENABLE`| You can disable indexing during the build for a faster build. The default value is **`No`**. | Required | -| `$AC_TEST_OS_VERSION` | Specify the test OS version. The default value is `latest`. User can use different OS version. For example: `16.3` | Required | +| `$AC_TEST_OS_VERSION` | Specify the test OS version. The default value is `latest`. User can use different OS version. For example: `16.3`. | Required | | `$AC_TEST_DEVICE` | Destination name of the test simulator device. Ex. `iPhone 14`. If you set a simulator name, the build will be installed into the given simulator. The default value is `iPhone 8 Plus`. | Required | | `$AC_TEST_PLATFORM` | Specify the test platform. The default value is `iOS Simulator`. | Required | @@ -63,7 +63,7 @@ Ensure the simulator type matches the OS version used. For example, if you use t :::caution -To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts#download-exported-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your workflow after this step. ::: diff --git a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md index 07284bb7f..b7df053cb 100644 --- a/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md +++ b/docs/workflows/react-native-specific-workflow-steps/app-center-code-push.md @@ -18,7 +18,7 @@ Before running the **App Center CodePush** step, you must complete certain prere | Prerequisite Workflow Step | Description | |-------------------------------------------------|-------------------------------------------------| -| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the CodePush process. After this step, the variable `AC_REPOSITORY_DIR` will be set. | +| [**Git Clone**](/workflows/common-workflow-steps/git-clone) | The repository needs to be cloned to begin the CodePush process. After this step, the variable `$AC_REPOSITORY_DIR` will be set. | @@ -40,7 +40,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|------------------| | `$AC_APPCENTER_TOKEN` | App Center API Token. | Required | -| `$AC_APPCENTER_PRIVATE_KEY` | App Center Private Key to sign updates. Upload your private key (.pem) to environment variables as a file and set its name as `AC_APPCENTER_PRIVATE_KEY`. | Optional | +| `$AC_APPCENTER_PRIVATE_KEY` | App Center Private Key to sign updates. Upload your private key (`.pem`) to environment variables as a file and set its name as `$AC_APPCENTER_PRIVATE_KEY`. | Optional | | `$AC_PROJECT_PATH` | Relative path of the React Native project. Leave it empty to use the parent repository path. | Optional | | `$AC_APPCENTER_OWNER` | Owner of the app. The app's owner can be identified in its URL, such as `https://appcenter.ms/users/JohnDoe/apps/myapp` for a user-owned app (where **JohnDoe** is the owner) and `https://appcenter.ms/orgs/Appcircle/apps/myapp` for an org-owned app (owner is **Appcircle**). | Required | | `$AC_APPCENTER_APPNAME` | The name of the app. The app's name can be identified in its URL, such as `https://appcenter.ms/users/JohnDoe/apps/myapp` for a user-owned app (where **myapp** is the app name) and `https://appcenter.ms/orgs/Appcircle/apps/myapp` for an org-owned app (owner is **myapp**). | Required | @@ -48,7 +48,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_APPCENTER_DEPLOYMENT` | This parameter specifies which deployment you want to release the update to. It defaults to `Staging`. | Optional | | `$AC_APPCENTER_ROLLOUT` | This parameter specifies the percentage of users (as an integer between 1 and 100) that should be eligible to receive this update. | Optional | | `$AC_APPCENTER_VERSION` | The latest version will be used if no version is set. | Optional | -| `$AC_APPCENTER_EXTRA` | Extra command line arguments for appcenter. For example, add `--debug` for verbose logs. | Optional | +| `$AC_APPCENTER_EXTRA` | Extra command line arguments for App Center. For example, add `--debug` for verbose logs. | Optional | --- diff --git a/docs/workflows/react-native-specific-workflow-steps/node-install.md b/docs/workflows/react-native-specific-workflow-steps/node-install.md index ef07b011b..c666db82f 100644 --- a/docs/workflows/react-native-specific-workflow-steps/node-install.md +++ b/docs/workflows/react-native-specific-workflow-steps/node-install.md @@ -1,7 +1,7 @@ --- title: Install Node description: Ensure the correct Node version for your React Native app with Install Node. A crucial step for building React Native applications. -tags: [react native, mobile, workflow, step] +tags: [react native, mobile, workflow, step, node, install, version] --- import Screenshot from '@site/src/components/Screenshot'; @@ -34,7 +34,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| -| `$AC_SELECTED_NODE_VERSION` | This step takes only the **node version** variable. You can specify the version directly in the step if you wish. Or you can get it from build [**Configurations**](/build/platform-build-guides/building-react-native-applications#build-configuration-for-react-native-ios-applications). | Optional | +| `$AC_SELECTED_NODE_VERSION` | This step takes only the **Node version** variable. You can specify the version directly in the step if you wish. Or you can get it from build [**Configurations**](/build/platform-build-guides/building-react-native-applications#build-configuration-for-react-native-ios-applications). | Optional | :::caution diff --git a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md index 9b7dea990..f5c53e3f6 100644 --- a/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md +++ b/docs/workflows/react-native-specific-workflow-steps/npm-yarn-commands.md @@ -1,7 +1,7 @@ --- title: NPM/Yarn Commands description: Learn to use NPM/Yarn commands for managing dependencies in your React Native applications. Enhance your app's functionality. -tags: [react native, mobile, workflow, step] +tags: [react native, mobile, workflow, step, npm, yarn, commands] --- import Screenshot from '@site/src/components/Screenshot'; @@ -29,7 +29,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | Variable Name | Description | Status | |-------------------------------|------------------------------------------------|--------| | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | -| `$AC_NPM_COMMAND_ARGS` | The NPM command to run. You can add different command parameters directly. The default is: `npm/yarn install` | Optional | +| `$AC_NPM_COMMAND_ARGS` | The NPM command to run. You can add different command parameters directly. The default is: `npm/yarn install`. | Optional | --- diff --git a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md index cff4e357c..3c2d563f9 100644 --- a/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md +++ b/docs/workflows/react-native-specific-workflow-steps/react-native-unit-test.md @@ -48,7 +48,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T :::caution -To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your Workflow after this step. +To view the output artifacts on the [**Download Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) page, please ensure that the [**Export Build Artifacts**](/workflows/common-workflow-steps/export-build-artifacts) step is included in your workflow after this step. ::: From 2abb940c742b30dd12429432dd8aa6c525199970 Mon Sep 17 00:00:00 2001 From: boztopuz Date: Thu, 5 Dec 2024 10:11:23 +0300 Subject: [PATCH 10/10] [BE-4789]: Fixed last feedbacks --- .../android-specific-workflow-steps/android-unit-tests.md | 4 ++-- .../app-center-android-distribution.md | 2 +- .../appsweep-mobile-security-testing.md | 2 +- .../flutter-specific-workflow-steps/firebase-deployment.md | 2 +- .../appdome-build-to-secure-for-ios.md | 2 +- docs/workflows/ios-specific-workflow-steps/slather.md | 2 +- .../ios-specific-workflow-steps/xcodebuild-for-devices.md | 4 ++-- 7 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md index b3512fae7..6bcdf4862 100644 --- a/docs/workflows/android-specific-workflow-steps/android-unit-tests.md +++ b/docs/workflows/android-specific-workflow-steps/android-unit-tests.md @@ -24,7 +24,7 @@ Before running the **Android Unit Tests** step, you must complete certain prereq :::danger -If you wish to view the test results on Appcircle's Test Reports page, it is essential to use the [Test Reports for Android](/workflows/android-specific-workflow-steps/test-reports-for-android) step after the **Android Unit Tests**. Please check out this document for more information: [Generating Test Report](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report) +If you wish to view the test results on Appcircle's Test Reports page, it is essential to use the [Test Reports for Android](/workflows/android-specific-workflow-steps/test-reports-for-android) step after the **Android Unit Tests**. Please check out this document for more information: [Generating Test Report](/continuous-testing/android-testing/running-android-unit-tests#generating-test-report). @@ -41,7 +41,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | `$AC_REPOSITORY_DIR` | This variable represents the path of the cloned Git repository. If this step runs after the [Git Clone](/workflows/common-workflow-steps/git-clone) step, the variable will be automatically populated. | Required | | `$AC_MODULE` | This variable specifies the project module to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can locate the available modules for your project. For more information, please refer to this [Android document](https://developer.android.com/studio/projects#ApplicationModules). | Required | | `$AC_VARIANTS` | This variable specifies the project variant to be built. This variable can also be set via the build [Configuration](/build/build-process-management/build-profile-configuration). In Android Studio, you can find the available variants for your project. For more information, please refer to this [Android document](https://developer.android.com/build/build-variants). | Required | -| `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. The default value is: `./` | Optional | +| `$AC_PROJECT_PATH` | Specifies the project path. If your project that needs to be built is **not located** in the root directory where it was cloned from Git, you should provide the subpath as a relative path. The default value is: `./`. | Optional | ### Output Variables diff --git a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md index d1abf7dc0..7b2396e05 100644 --- a/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md +++ b/docs/workflows/android-specific-workflow-steps/app-center-android-distribution.md @@ -64,7 +64,7 @@ We recommend using [**Environment Variables**](/environment-variables/managing-v | `$AC_APPCENTER_GROUPS` | Specifies the group names in the App Center. For more than one group name to be distributed, you must separate them with a comma. For example: `group0,group1,..,groupn` | Optional | | `$AC_APPCENTER_STORE` | Specifies the store name. For example: `App Store`, `Google Play`, and `Intune`. | Optional | | `$AC_APPCENTER_RELEASE_NOTES_PATH` | Specifies the release note path. If you use the [**Publishing Release Notes**](/workflows/common-workflow-steps/publish-release-notes) component before this step, `release-notes.txt` will be used as release notes. The default value is `AC_OUTPUT_DIR/release-notes.txt`. | Optional | -| `$AC_APPCENTER_MAPPING_PATH` | Specifies the path of the `mapping.txt` file. Example: `$AC_REPOSITORY_DIR/build/app/outputs/mapping/release/mapping.txt` | Optional | +| `$AC_APPCENTER_MAPPING_PATH` | Specifies the path of the `mapping.txt` file. Example: `$AC_REPOSITORY_DIR/build/app/outputs/mapping/release/mapping.txt`. | Optional | | `$AC_APPCENTER_MANDATORY` | Specifies whether the update should be considered mandatory. The options are `true` and `false`. The default value is `false`. | Optional | | `$AC_APPCENTER_NOTIFY` | Notify testers of this release. The options are `true` and `false`. The default value is `false`. | Optional | | `$AC_APPCENTER_VERSION` | [App Center CLI](https://learn.microsoft.com/tr-tr/appcenter/cli/) version. The latest version will be used if no version is set. | Optional | diff --git a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md index e26ac71ff..42448e363 100644 --- a/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md +++ b/docs/workflows/android-specific-workflow-steps/appsweep-mobile-security-testing.md @@ -1,7 +1,7 @@ --- title: AppSweep Mobile Security Testing description: Learn how to use the AppSweep Mobile Security Testing workflow step in Appcircle -tags: [android, mobile, android, security, testing, appsweep] +tags: [android, mobile, security, testing, appsweep] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md index a2406e356..9c168f006 100644 --- a/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md +++ b/docs/workflows/flutter-specific-workflow-steps/firebase-deployment.md @@ -1,7 +1,7 @@ --- title: Firebase Deployment description: Firebase deployment is quick, and secure app launches. Get started with our concise guide to deploying on Firebase efficiently. -tags: [firebase, mobile, web, distribution] +tags: [firebase, web, distribution, deployment, web applications] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md index a97532988..78aaf167d 100644 --- a/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md +++ b/docs/workflows/ios-specific-workflow-steps/appdome-build-to-secure-for-ios.md @@ -68,7 +68,7 @@ To view the output artifacts on the [**Download Artifacts**](/workflows/common-w | Variable Name | Description | Status | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -------- | -| `AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured `.ipa` file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing` | Required | +| `AC_APPDOME_SECURED_IPA_PATH` | Local path of the secured `.ipa` file. Available when 'Signing Method' set to `On-Appdome` or `Private-Signing`. | Required | | `AC_APPDOME_PRIVATE_SIGN_SCRIPT_PATH` | TLocal path of the `.sh` sign script file. Available when `Signing Method` set to `Auto-Dev-Signing`. | Required | | `AC_APPDOME_CERTIFICATE_PATH` | Local path of the Certified Secure Certificate `.pdf` file. | Required | diff --git a/docs/workflows/ios-specific-workflow-steps/slather.md b/docs/workflows/ios-specific-workflow-steps/slather.md index 21b3eb0bf..e28343792 100644 --- a/docs/workflows/ios-specific-workflow-steps/slather.md +++ b/docs/workflows/ios-specific-workflow-steps/slather.md @@ -1,7 +1,7 @@ --- title: Slather description: Use Slather to convert Xcode's test results into various formats. Prerequisites include Xcodebuild for Tests and Git Clone. -tags: [ios, build, test, unit, ui, testing, step] +tags: [slather, ios, build, test, unit, ui, testing, step] --- import Screenshot from '@site/src/components/Screenshot'; diff --git a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md index dbe524127..ebdeee588 100644 --- a/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md +++ b/docs/workflows/ios-specific-workflow-steps/xcodebuild-for-devices.md @@ -44,7 +44,7 @@ This step contains some input variable(s). It needs these variable(s) to work. T | `$AC_REPOSITORY_DIR` | Specifies the cloned repository directory. This path will be generated after the [**Git Clone**](/workflows/common-workflow-steps/git-clone) step. | Required | | `$AC_OUTPUT_DIR_PATH` | This variable specifies the path of the artifacts that will be generated after the build is complete. | Required | | `$AC_SCHEME` | Specifies the project scheme for build. If you filled in **`Configuration => Build Scheme`**, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | -| `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: `-quiet` | | +| `$AC_ARCHIVE_FLAGS` | Specifies the extra xcodebuild flag. For example: `-quiet`. | Optional | | `$AC_PROJECT_PATH` | Specifies the project path. For example: `./appcircle.xcodeproj`. If you filled in **`Configuration => Project or Workspace`**, this variable comes from [Configuration](/build/platform-build-guides/building-ios-applications#build-configuration). | Required | | `$AC_CERTIFICATES` | This variable specifies the path of the certificates to be signed. | Required | | `$AC_BUNDLE_IDENTIFIERS` | This variable holds the Bundle Identifier of the application to be built. | Required | @@ -93,7 +93,7 @@ To address the need to add a new command after completing the `xcodebuild` comma :::caution -Before running the script, some variables must be changed, and new variables must be added to the **custom script**. +Before running the script, some variables must be changed, and new variables must be added to the **Custom Script**. :::