> For the complete documentation index, see [llms.txt](https://qubic.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qubic.gitbook.io/docs/guides/qubic-connect-sdk/installation.md).

# 安裝

## Installation

{% tabs %}
{% tab title="Yarn" %}

```bash
$ yarn add @qubic-connect/core
```

```javascript
import QubicConnect from '@qubic-connect/core';
```

{% endtab %}

{% tab title="NPM" %}

```bash
$ npm install @qubic-connect/core
```

```javascript
import QubicConnect from '@qubic-connect/core';
```

{% endtab %}

{% tab title="CDN" %}

```html
<script type="text/javascript" src="https://unpkg.com/@qubic-connect/core"></script>
```

{% endtab %}
{% endtabs %}

## Initialize

{% hint style="info" %}
**哪裏可以找到 API key 和 secret？**

如果你已經訂閱或購買 Qubic Creator 的服務，請前往 [Qubic Creator Admin 後台](https://admin.qubic.market/developer)，並找到左側側邊欄中的 [開發者工具](https://admin.qubic.market/developer)，接著找到 **Creator Storefront API & Qubic Connect SDK**，點擊 **建立 Creator Storefront API & Qubic Connect SDK**，即可獲得 API key 和 secret。
{% endhint %}

```javascript
const qubicConnect = new QubicConnect({
  name: 'Display Name',
  key: 'API_KEY',
  secret: 'API_SECRET',
});
```

{% hint style="warning" %}
如果你使用 React 或相似的 Framework，你可能需要在全域環境或 Context 中執行以上初始化的程式碼片段。

請避免在同一個生命週期中重複初始化，可能會造成無法預期的錯誤。
{% endhint %}