文档Commerce云基础架构上的 Commerce 指南

管理扩展

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 开发人员

通过从Commerce Marketplace添加扩展，您可以扩展Adobe Commerce应用程序功能。 例如，您可以添加主题以更改店面的外观，或者添加语言包以将店面和管理员本地化。

NOTE
为了避免安装问题，必须使用拥有云项目的同一帐户(MAGEID)完成所有Marketplace购买。

扩展的编辑器名称

尽管本节讨论如何从Commerce Marketplace获取扩展名的编辑器名称和版本，但您可以在模块的编辑器文件中找到​ any ​模块的名称和版本。 在文本编辑器中打开composer.json文件并记下"name"和"version"值。

要从Commerce Marketplace ​中获取模块的编辑器名称，请执行以下操作：

  1. 使用用于购买该组件的用户名和密码登录到Commerce Marketplace。

  2. 单击右上角的用户名并选择​ 我的个人资料。

    访问你的Marketplace帐户

  3. 在​ 我的帐户 ​页面上，单击​ 我的购买。

    市场购买历史记录

  4. 在​ 我的购买 ​页面上，选择您购买的模块，然后单击​ 技术详细信息。

  5. 单击​ 复制 ​以将Component name复制到剪贴板。

  6. 打开文本编辑器并粘贴组件名称并附加一个冒号字符(:)。

  7. 在​ 技术详细信息 ​中，单击​ 复制 ​以将Component version复制到剪贴板。

  8. 在文本编辑器中，将版本号附加到组件名称中冒号的后面。 例如：

    code language-text 
    extension-name/magento2:1.0.1

安装扩展

在向实施中添加扩展时，Adobe建议在开发分支中工作。 安装扩展时，扩展名(<VendorName>_<ComponentName>)会自动插入到app/etc/config.php文件中。 无需直接编辑文件。

要安装扩展：

  1. 在本地工作站上，转到您的项目目录。

  2. 创建或签出开发分支。 查看分支。

  3. 使用编辑器名称和版本，将扩展名添加到composer.json文件的require部分。

    code language-bash 
    composer require <extension-name>:<version> --no-update

  4. 更新项目依赖关系。

    code language-bash 
    composer update

  5. 添加、提交和推送代码更改。

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Install <extension-name>"
    code language-bash 
    git push origin <branch-name>
    note warning
    WARNING
    安装扩展时，在将代码更改推送到远程环境时必须包含composer.lock文件。 composer install命令读取composer.lock文件以在远程环境中启用定义的依赖项。

  6. 构建和部署完成后，使用SSH登录到远程环境并验证已安装的扩展。

    code language-bash 
    bin/magento module:status <extension-name>

    扩展名使用格式： <VendorName>_<ComponentName>。

    示例响应：

    code language-none 
    Module is enabled

    如果遇到部署错误，请参阅扩展部署失败。

管理扩展

使用编辑器添加扩展时，部署过程会自动启用该扩展。 如果已安装扩展，则可以使用CLI启用或禁用该扩展。 管理扩展时，请使用格式： <VendorName>_<ComponentName>

在登录到远程环境时，切勿启用或禁用扩展。

启用或禁用扩展：

  1. 在本地工作站上，转到您的项目目录。

  2. 启用或禁用模块。 module命令使用请求的模块状态更新config.php文件。

    启用模块。

    code language-bash 
    bin/magento module:enable <module-name>

    禁用模块。

    code language-bash 
    bin/magento module:disable <module-name>

  3. 如果启用了模块，请使用ece-tools刷新配置。

    code language-bash 
    ./vendor/bin/ece-tools module:refresh

  4. 验证模块的状态。

    code language-bash 
    bin/magento module:status <module-name>

  5. 添加、提交和推送代码更改。

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Disable <extension-name>"
    code language-bash 
    git push origin <branch-names>

升级扩展

在继续之前，您需要具有扩展的编辑器名称和版本。 此外，请确认该扩展与您的项目和Adobe Commerce版本兼容。 特别是，在开始之前检查所需的PHP版本。

要更新扩展：

  1. 在本地工作站上，转到您的项目目录。

  2. 创建或签出开发分支。 查看分支。

  3. 在文本编辑器中打开composer.json文件。

  4. 找到扩展并更新版本。

  5. 保存更改并退出文本编辑器。

  6. 更新项目依赖关系。

    code language-bash 
    composer update

  7. 添加、提交和推送代码更改。

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Update <extension-name>"
    code language-bash 
    git push origin <branch-names>

如果遇到错误，请参阅从组件故障中恢复。 要了解有关将扩展与Adobe Commerce结合使用的更多信息，请参阅​ 管理员指南 ​中的扩展。

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26