---
title: "入门"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/online-store-3-0-themes/integrate-apps-with-themes/theme-app-extension/get-started'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/online-store-3-0-themes/integrate-apps-with-themes/theme-app-extension/get-started.md'
---
# 入门

在本教程中，你将会学到如何创建并发布一个主题应用扩展。

* * *

## 准备工作{#tr2n8}

-   在 SHOPLINE 创建一个 [合作伙伴账号](https://developer.myshopline.com)。
    
-   在合作伙伴后台上 [创建一个应用](https://developer.shopline.com/zh-hans-cn/docs/apps/development-tool/shopline-cli/build-apps-using-shopline-cli.md)。
    
-   在合作伙伴后台上创建一个 [开发商店](https://developer.shopline.com/zh-hans-cn/docs/apps/development-tool/development-stores/overview.md)。
    
-   在开发商店上安装你的应用。
    
-   安装 [SHOPLINE CLI](https://developer.shopline.com/zh-hans-cn/docs/online-store-3-0-themes/development-tools/cli/overview.md) 工具。
    
-   为你的开发商店安装一个 OS 3.0 版本的主题。
    

* * *

## 第一步：本地创建主题应用扩展{#TSHtt}

在本地使用 SHOPLINE CLI 创建一个主题应用扩展目录。

1.  在终端窗口进入一个空目录。
    

```shell
cd <my-directory>
```

2.  登录开发商店。
    

```shell
sl login --store <MY_STORE>.myshopline.com
```

3.  创建主题应用扩展。
    

```shell
sl extension create
```

4.  根据提示选择合适的选项。选择完毕后，你会在你的目录中看见一个叫 `theme-app-extension` 的文件夹。
    

<img src="https://s2cdn.myshopline.com/slfs/op-new/175196190026770/1745290371220-41d0b98f-03f1-441f-873a-f6f7e5d96487.png" alt="" />

* * *

## 第二步：推送主题应用扩展{#iCoPP}

1.  进入主题应用扩展目录。
    

```shell
cd theme-app-extension
```

2.  推送主题应用扩展。
    

```shell
sl extension push
```

3.  根据提示选择合适的选项。
    

<img src="https://s2cdn.myshopline.com/slfs/op-new/175161456812023/1749551646684-11af5682-b00a-4e0d-896d-12e1eb3ef77b.png" alt="" />

4.  在 SHOPLINE 合作伙伴后台，进入到应用扩展，点击如下图所示的切换按钮将应用扩展更改成草稿版本。
    

<img src="https://s2cdn.myshopline.com/slfs/op-new/175271636720087/1749551543265-1650a129-299d-46d8-bb49-3ec5509d374e.png" alt="" />

* * *

## 第三步：测试你的更改{#iehuP}

1.  在你的商家后台中，找到 **在线商店**，选择 OS 3.0 版本主题并点击 **设计** 按钮，进入到主题编辑器中。
    
2.  在主题编辑器主界面中，点击 **添加组件**，选择 **应用**，选择你应用下的 App Block 添加到主题中。
    
3.  保存修改后的主题。
    
4.  验证主题应用扩展是否符合预期。
    

* * *

## 第四步：发布主题应用扩展{#uycLQ}

1.  将主题应用扩展推送到 SHOPLINE 合作伙伴后台。
    

```shell
sl extension push
```

2.  推送成功后，会在你的终端显示你的合作伙伴后台应用版本的链接。
    
3.  点击链接进入应用版本创建页面。点击 **创建版本**。
    
4.  关闭并禁用草稿版本扩展的预览。
    

<img src="https://s2cdn.myshopline.com/slfs/op-new/175196240846116/1749465962186-5ad22d71-4916-4574-8a4e-6689fc2356ae.png" alt="" /><img src="https://s2cdn.myshopline.com/slfs/op-new/175084689990314/1750321789541-a25e355d-f6be-4e0f-b168-682cd6d99d77.png" alt="" />

5.  点击返回按钮，找到 **应用版本**并点击进入，在此创建并发布扩展版本。
    

<img src="https://s2cdn.myshopline.com/slfs/op-new/175161498928887/1749466289740-018a1cf9-8836-42ae-9729-636a756567c3.png" alt="" />