ci: add Jenkinsfile and config for e2e mobile tests

ci/Jenkinsfile.test-e2e.android

@@ -0,0 +1,256 @@
+#!/usr/bin/env groovy
+library '[email protected]'
+
+pipeline {
+  agent {
+    dockerfile {
+      label 'linuxcontainer'
+      filename 'tests.Dockerfile'
+      dir 'ci'
+      args '--user jenkins'
+    }
+  }
+
+  parameters {
+    gitParameter(
+      name: 'GIT_REF',
+      description: 'Git branch to checkout.',
+      branchFilter: 'origin/(.*)',
+      branch: '',
+      defaultValue: 'master',
+      quickFilterEnabled: false,
+      selectedValue: 'DEFAULT',
+      sortMode: 'ASCENDING_SMART',
+      tagFilter: '*',
+      type: 'PT_BRANCH'
+    )
+    string(
+      name: 'BUILD_SOURCE',
+      description: 'URL to APK or Jenkins build (pkg/*.apk). Required when BROWSERSTACK_APP_ID is empty.',
+      defaultValue: ''
+    )
+    string(
+      name: 'BROWSERSTACK_APP_ID',
+      description: 'Existing BrowserStack app identifier (bs://...). Leave empty to upload from BUILD_SOURCE.',
+      defaultValue: ''
+    )
+    choice(
+      name: 'TEST_DEVICE_ID',
+      description: 'BrowserStack device id to run on (leave empty to use the environment default).',
+      choices: ['', 'galaxy_tab_s10p_android_15', 'pixel_8_android_14', 'pixel_7_android_13', 'samsung_s23_android_13']
+    )
+    string(
+      name: 'PYTEST_ARGS',
+      description: 'Pytest flags (e.g. "-m smoke" or "-m critical") and other args.',
+      defaultValue: '-n=5 -m smoke tests'
+    )
+  }
+
+  options {
+    timestamps()
+    timeout(time: 120, unit: 'MINUTES')
+    buildDiscarder(logRotator(
+      daysToKeepStr: '30',
+      numToKeepStr: '30',
+      artifactNumToKeepStr: '30',
+    ))
+    disableRestartFromStage()
+  }
+
+  environment {
+    VIRTUAL_ENV = "${env.WORKSPACE_TMP}/venv-appium"
+    PYTHONUNBUFFERED = "1"
+    TEST_DEVICE_ID = "${params.TEST_DEVICE_ID}"
+    BROWSERSTACK_PROJECT_NAME = "Mobile E2E ${utils.getBuildType()}"
+  }
+
+  stages {
+    stage('Prep') {
+      steps {
+        script {
+          setNewBuildName()
+          updateGitHubStatus()
+        }
+      }
+    }
+
+    stage('Setup Python environment') {
+      steps {
+        dir('test/e2e_appium') {
+          sh """
+            set -euo pipefail
+            python3 -m venv ${VIRTUAL_ENV}
+            source ${VIRTUAL_ENV}/bin/activate
+            pip install --upgrade pip
+            pip install -r requirements.txt
+          """
+        }
+      }
+    }
+
+    stage('Use provided BrowserStack app') {
+      when {
+        expression { params.BROWSERSTACK_APP_ID?.trim() }
+      }
+      steps {
+        script {
+          env.BROWSERSTACK_APP_ID = params.BROWSERSTACK_APP_ID.trim()
+          echo "Using provided BrowserStack app id: ${env.BROWSERSTACK_APP_ID}"
+        }
+      }
+    }
+
+    stage('Download') {
+      when {
+        allOf {
+          expression { !params.BROWSERSTACK_APP_ID?.trim() }
+          expression { params.BUILD_SOURCE?.startsWith('http') }
+        }
+      }
+      steps { timeout(5) { script { dir('test/e2e_appium') {
+        if (!params.BUILD_SOURCE?.trim()) {
+          error('Specify BUILD_SOURCE when BROWSERSTACK_APP_ID is empty.')
+        }
+        sh 'mkdir -p ./pkg/'
+        fileOperations([
+          fileDownloadOperation(
+            url:            params.BUILD_SOURCE,
+            targetFileName: 'downloaded.apk',
+            targetLocation: './pkg/',
+            userName:       '',
+            password:       '',
+          )
+        ])
+        def apkPath = utils.findFile('test/e2e_appium/pkg/*.apk')
+        if (!apkPath) {
+          error("Unable to locate APK under pkg/. Ensure BUILD_SOURCE produces pkg/*.apk artifacts.")
+        }
+        env.APK_PATH = apkPath
+        echo "APK ready at ${env.APK_PATH}"
+      } } } }
+    }
+
+    stage('Copy') {
+      when {
+        allOf {
+          expression { !params.BROWSERSTACK_APP_ID?.trim() }
+          expression { !params.BUILD_SOURCE?.startsWith('http') }
+        }
+      }
+      steps { timeout(5) { script { dir('test/e2e_appium') {
+        if (!params.BUILD_SOURCE?.trim()) {
+          error('Specify BUILD_SOURCE when BROWSERSTACK_APP_ID is empty.')
+        }
+        copyArtifacts(
+          projectName: params.BUILD_SOURCE,
+          filter:      'pkg/*.apk',
+          selector:    lastWithArtifacts(),
+          target:      './'
+        )
+        def apkPath = utils.findFile('test/e2e_appium/pkg/*.apk')
+        if (!apkPath) {
+          error("Unable to locate APK under pkg/. Ensure BUILD_SOURCE produces pkg/*.apk artifacts.")
+        }
+        env.APK_PATH = apkPath
+        echo "APK ready at ${env.APK_PATH}"
+      } } } }
+    }
+
+    stage('Upload APK to BrowserStack') {
+      when {
+        expression { !env.BROWSERSTACK_APP_ID }
+      }
+      steps {
+        script {
+          withCredentials([
+            usernamePassword(
+              credentialsId: 'browserstack-status-desktop',
+              usernameVariable: 'BROWSERSTACK_USERNAME',
+              passwordVariable: 'BROWSERSTACK_ACCESS_KEY'
+            )
+          ]) {
+            def response = sh(
+              script: "./scripts/upload_browserstack_apk.sh",
+              returnStdout: true
+            ).trim()
+            def result = readJSON text: response
+            def appUrl = result?.app_url
+            if (!appUrl) {
+              error("BrowserStack upload failed: ${response}")
+            }
+            env.BROWSERSTACK_APP_ID = appUrl
+            env.BROWSERSTACK_BUILD_NAME = result?.custom_id
+            env.BROWSERSTACK_BUILD_IDENTIFIER = env.BUILD_NUMBER
+            echo "BrowserStack app uploaded: ${env.BROWSERSTACK_APP_ID}"
+          }
+        }
+      }
+    }
+
+    stage('Run pytest suite') {
+      steps {
+        script {
+          dir('test/e2e_appium') {
+            println("Using TEST_DEVICE_ID: ${env.TEST_DEVICE_ID}")
+
+            withCredentials([
+              usernamePassword(
+                credentialsId: 'browserstack-status-desktop',
+                usernameVariable: 'BROWSERSTACK_USERNAME',
+                passwordVariable: 'BROWSERSTACK_ACCESS_KEY'
+              )
+            ]) {
+              sh "${VIRTUAL_ENV}/bin/python -m pytest --env browserstack ${params.PYTEST_ARGS?.trim() ?: ''}"
+            }
+          }
+        }
+      }
+    }
+
+    stage('Publish test results') {
+      steps {
+        script {
+          def runId = env.E2E_RUN_ID?.trim()
+          def reportsPattern = runId ? "test/e2e_appium/reports/${runId}/**/*.xml" : "test/e2e_appium/reports/**/*.xml"
+          junit allowEmptyResults: true, testResults: reportsPattern
+          def archivePattern = runId ? "test/e2e_appium/reports/${runId}/**/*" : "test/e2e_appium/reports/**/*"
+          archiveArtifacts artifacts: archivePattern, allowEmptyArchive: true
+        }
+      }
+    }
+  }
+
+  post {
+    success {
+      script {
+        github.notifyPR(true)
+      }
+    }
+    failure {
+      script {
+        github.notifyPR(false)
+      }
+    }
+    cleanup {
+      cleanWs(disableDeferredWipeout: true)
+    }
+  }
+}
+
+def setNewBuildName() {
+  if (currentBuild.upstreamBuilds) {
+    def parent = utils.parentOrCurrentBuild()
+    currentBuild.displayName = parent.getFullDisplayName().minus('status-desktop » ')
+  }
+}
+
+def updateGitHubStatus() {
+  if (params.BUILD_SOURCE ==~ /.*\/PR-[0-9]+\/?$/) {
+    github.statusUpdate(
+      context: 'jenkins/prs/tests/e2e-android',
+      commit: jenkins.getJobCommitByPath(params.BUILD_SOURCE),
+      repo_url: 'https://github.com/status-im/status-desktop'
+    )
+  }
+}
+

scripts/upload_browserstack_apk.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Upload APK to BrowserStack and output JSON response to stdout
+# Requires environment variables:
+#   APK_PATH - Path to the APK file
+#   BROWSERSTACK_USERNAME - BrowserStack username
+#   BROWSERSTACK_ACCESS_KEY - BrowserStack access key
+#   BUILD_NUMBER - Build number (optional, defaults to current timestamp)
+
+if [[ -z "${APK_PATH:-}" ]]; then
+  echo "Error: APK_PATH environment variable is required" >&2
+  exit 1
+fi
+
+if [[ ! -f "${APK_PATH}" ]]; then
+  echo "Error: APK_PATH does not exist or is not a file: ${APK_PATH}" >&2
+  exit 1
+fi
+
+if [[ ! -r "${APK_PATH}" ]]; then
+  echo "Error: APK_PATH is not readable: ${APK_PATH}" >&2
+  exit 1
+fi
+
+if [[ -z "${BROWSERSTACK_USERNAME:-}" ]]; then
+  echo "Error: BROWSERSTACK_USERNAME environment variable is required" >&2
+  exit 1
+fi
+
+if [[ -z "${BROWSERSTACK_ACCESS_KEY:-}" ]]; then
+  echo "Error: BROWSERSTACK_ACCESS_KEY environment variable is required" >&2
+  exit 1
+fi
+
+APK_NAME=$(basename "${APK_PATH}")
+SANITIZED_NAME=$(printf '%s' "${APK_NAME}" | tr -cs '[:alnum:]._-' '-' | cut -c1-80)
+BUILD_ID="${BUILD_NUMBER:-$(date +%s)}"
+CUSTOM_ID="${SANITIZED_NAME}-${BUILD_ID}"
+
+curl -s -u "${BROWSERSTACK_USERNAME}:${BROWSERSTACK_ACCESS_KEY}" \
+  -X POST "https://api-cloud.browserstack.com/app-automate/upload" \
+  -F "file=@${APK_PATH}" \
+  -F "custom_id=${CUSTOM_ID}"
+

test/e2e_appium/.gitignore

@@ -46,6 +46,7 @@ report/
 reports/
 screenshots/
 logs/
+log/
 *.log
 result.xml
 junit.xml

test/e2e_appium/config/environments/base.yaml

@@ -27,13 +27,11 @@ timeouts:
 
 logging:
   level: "INFO"
-  enable_screenshots: true
-  enable_video_recording: true
   enable_xml_report: true
   enable_html_report: true
   enable_junit_report: true
 
 directories:
-  logs: "logs"
-  reports: "reports"
-  screenshots: "screenshots"
+  reports: "reports/${E2E_RUN_ID:-local}"
+  logs: "reports/${E2E_RUN_ID:-local}/logs"
+  screenshots: "reports/${E2E_RUN_ID:-local}/screenshots"

test/e2e_appium/config/environments/browserstack.yaml

@@ -13,10 +13,10 @@ provider:
     auth:
       username: "${BROWSERSTACK_USERNAME:-}"
       access_key: "${BROWSERSTACK_ACCESS_KEY:-}"
-    build_name_template: "Status_E2E_Mobile"
+    build_name_template: "${BROWSERSTACK_BUILD_NAME:-${BROWSERSTACK_BUILD_IDENTIFIER:-${GIT_COMMIT:-Status Mobile}}}"
     build_identifier_template: "${BROWSERSTACK_BUILD_IDENTIFIER:-${GIT_COMMIT:-local}}"
-    session_name_template: "${TEST_NAME:-Status Test}"
-    project_name: "Status E2E Appium"
+    session_name_template: "${TEST_NAME:-${PYTEST_CURRENT_TEST:-Status Test}}"
+    project_name: "${BROWSERSTACK_PROJECT_NAME:-Status E2E Appium}"
     hub_url: "https://hub-cloud.browserstack.com/wd/hub"
     max_parallel_sessions: 5
     sdk:
@@ -29,7 +29,13 @@ device_defaults:
     newCommandTimeout: 300
     bstack:options:
       deviceOrientation: "landscape"
-      "appiumVersion" : "2.19.0"
+      "appiumVersion": "2.19.0"
+      video: true
+      debug: false
+      networkLogs: false
+      appiumLogs: true
+      deviceLogs: true
+      appProfiling: false
     orientation: "LANDSCAPE"
     appium:unicodeKeyboard: true
     appium:resetKeyboard: true
@@ -76,7 +82,5 @@ execution:
 
 logging:
   level: "INFO"
-  enable_video_recording: true
-  enable_screenshots: true
   enable_xml_report: true
   enable_html_report: true

test/e2e_appium/config/environments/local.yaml

@@ -53,9 +53,4 @@ timeouts:
 
 logging:
   level: "DEBUG"
-  enable_video_recording: false
 
-directories:
-  logs: "logs/local"
-  reports: "reports/local"
-  screenshots: "screenshots/local"

test/e2e_appium/config/logging_config.py

@@ -247,9 +247,9 @@ def setup_logging(config: Optional[LoggingConfig] = None) -> Dict[str, Any]:
     if config is None:
         config = LoggingConfig()
 
-    # Create logs directory
+    # Create logs directory (create parents for nested per-run paths)
     logs_dir = Path(config.logs_dir)
-    logs_dir.mkdir(exist_ok=True)
+    logs_dir.mkdir(parents=True, exist_ok=True)
 
     # Clear any existing handlers
     root_logger = logging.getLogger()