jss

Sitecore JavaScript渲染SDK（JSS）

该存储库包含所有Sitecore JSS软件包和模板的源代码，以帮助您开始使用Sitecore JSS。

JSS入门

要开发JSS应用程序，您需要：

• 由节点（Mac，Windows，Linux）支持的操作系统。
• 节点。我们建议使用最新的长期支持（LTS）版本。

要在生产中运行JSS应用程序或使用Sitecore数据开发，您需要使用已安装的无头服务模块将应用程序连接到Sitecore实例（需要Sitecore无头服务许可证）。 Sitecore需要窗口，但是Sitecore实例不需要本地。您可以使用在虚拟机或远程服务器上安装的Sitecore实例。

标识您的Sitecore版本的JSS版本

JSS版本与Sitecore版本相结合。当前的JSS版本与最新版本的Sitecore兼容。

如果您使用旧版本的Sitecore，则在创建JSS项目之前，需要确定哪些JSS版本与Sitecore XP版本兼容。

为您的Sitecore XP版本确定正确的JSS版本：

• 对于Sitecore XP 7.5-9.3，在Sitecore模块兼容性表中，Sitecore XP 7.5-9.3，在“无头服务”部分中，确定您的Sitecore版本的正确JavaScript Services版本。
• 对于Sitecore XP 10.0及更高版本，在Sitecore模块兼容性表中，Sitecore XP 10.0及以后的版本，在“无头服务”部分中，为您的Sitecore版本确定正确的JavaScript Services版本。

开始使用JSS的最新版本

创建JSS项目：

1. 在终端中，运行以下命令之一并按照提示：

    npm init sitecore-jss
   

   或者

    npx create-sitecore-jss
   

2. 将目录更改为您的应用程序文件夹：

    cd my-first-jss-app
   

3. 启动开发服务器：

    jss start
   

使用较旧版本

如果您需要使用旧版本的JSS，则必须安装JSS CLI版本19.x或以上。

为旧版本的JSS和Sitecore创建JSS项目：

1. 为您的Sitecore XP版本确定正确的JSS版本。

2. 运行JSS CLI安装命令：

    npm i @sitecore-jss/sitecore-jss-cli@<version>
   

   将<version>用所需的版本替换。例如， npm i @sitecore-jss/[email protected] 。

3. 在终端中，通过运行以下命令来创建JSS项目：

    jss create my-jss-app react --branch release/13.0.0
   

   该命令使用--branch选项，您需要在JSS存储库中提供分支的名称。您可以使用释放分支或存储库中的任何其他分支。

4. 将目录更改为您的应用程序文件夹：

    cd my-first-jss-app
   

5. 启动开发服务器：

    jss start
   

文档和社区资源

• JSS官方文档：
  • XM云
  • XP
• Stackexchange
• 社区懈怠
• Sitecore社区论坛

贡献

我们非常感谢社区贡献错误修复和改进。我们欢迎所有努力发展和改善Sitecore JavaScript渲染SDK；请阅读下面学习如何参与这些努力。

行为守则

Sitecore采用了一项行为准则，我们希望项目参与者遵守。请阅读全文，以便您可以理解哪些行动将被容忍。

贡献指南

阅读我们的贡献指南，以了解我们的开发过程，如何提出错误修复和改进以及如何构建和测试您的变化以做出反应。

执照

Sitecore JavaScript服务使用Apache 2.0许可证。

支持