Merge branch 'feature/add-api-compatibility-ci-job' into 'master'

ci: add API compatibility check job for merge requests

Closes IDF-8483

See merge request espressif/esp-idf!45963

.gitlab/ci/host-test.yml

@@ -53,6 +53,25 @@ check_public_headers:
         done
       done
 
+check_api_compatibility:
+  extends:
+    - .host_test_template
+    - .rules:test:host_test
+  needs:
+    - pipeline_variables
+  variables:
+    IDF_TOOLCHAIN: clang
+    INSTALL_EXTRA_TOOLS: esp-clang-libs
+  allow_failure: true
+  script:
+    - pip install "esp-api-check[gitlab] @ git+https://gitlab-ci-token:${ESPCI_TOKEN}@${GITLAB_HTTPS_HOST}/espressif/esp-api-check.git"
+    - python -m esp_api_check install-clang-bindings
+    - python -m esp_api_check gitlab
+      --gitlab-url "https://${GITLAB_HTTPS_HOST}"
+      --gitlab-token ${ESPCI_TOKEN}
+      --head-sha ${CI_MERGE_REQUEST_SOURCE_BRANCH_SHA}
+      --project-dir ${CI_PROJECT_DIR}/tools/test_apps/system/test_api_check
+
 test_nvs_coverage:
   extends:
     - .host_test_template