При работе с Salesforce DX и Salesforce CLI вы можете столкнуться с ошибкой «Invalid sourceApiVersion» в файле sfdx-project.json. Эта ошибка обычно возникает, когда sourceApiVersion, указанный в файле, не соответствует ожидаемой версии. В этой статье мы рассмотрим различные способы устранения этой ошибки, сопровождаемые примерами кода.

Метод 1. Обновите sourceApiVersion вручную
Самый простой способ устранить эту ошибку — вручную обновить sourceApiVersion в файле sfdx-project.json. Откройте файл и найдите атрибут «sourceApiVersion». Измените значение на ожидаемую версию (например, «49.0») и сохраните файл. Вот пример того, как должен выглядеть обновленный атрибут:

{
  "packageDirectories": [
    {
      "path": "force-app",
      "default": true,
      "package": "My Package",
      "versionName": "Version 1.0",
      "versionNumber": "1.0.0.NEXT",
      "sourceApiVersion": "49.0"
    }
  ],
  "namespace": "",
  "sfdcLoginUrl": "https://login.salesforce.com",
  "sourceApiVersion": "49.0"
}

Метод 2: используйте интерфейс командной строки Salesforce для обновления версии API
CLI Salesforce предоставляет удобную команду для обновления sourceApiVersion. Откройте командную строку или терминал и перейдите в каталог вашего проекта. Выполните следующую команду:

sfdx force:project:upgrade --sourceapiVersion 49.0

Эта команда обновляет sourceApiVersion в файле sfdx-project.json до указанной версии (в данном примере 49.0).

Метод 3: создание нового проекта с правильной версией API
Если обновление sourceApiVersion вручную или с помощью CLI не устраняет ошибку, вы можете создать новый проект с правильной версией API. Выполните следующие действия:

1. Создайте новый каталог для своего проекта.
2. Перейдите в новый каталог с помощью командной строки или терминала.
3. Выполните следующую команду:

sfdx force:project:create --manifest -n MyProject --template standard

Эта команда создает новый проект с версией API по умолчанию (обычно это последняя версия). Затем вы можете скопировать существующие файлы проекта в новый проект и продолжить разработку.

Ошибку «Invalid sourceApiVersion» в файле sfdx-project.json можно устранить, обновив sourceApiVersion вручную, используя интерфейс командной строки Salesforce или создав новый проект с правильной версией API. Следуя этим методам, вы можете гарантировать, что ваш проект Salesforce DX соответствует ожидаемой версии, и избежать проблем с совместимостью.