> ## Documentation Index
> Fetch the complete documentation index at: https://ext.eplus.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cài đặt

> Cài Gmail Alias Toolkit từ kho tiện ích, gói phát hành hoặc mã nguồn

## Cách cài đặt khuyến nghị

Cài đặt từ kho tiện ích chính thức là cách đơn giản nhất và được cập nhật tự động.

<CardGroup cols={2}>
  <Card title="Chrome Web Store" icon="chrome" href="https://chromewebstore.google.com/detail/cbapjlppdfbnfbopdegobofmfijnlibl">
    Khuyến nghị cho Google Chrome và phần lớn trình duyệt Chromium.
  </Card>

  <Card title="Firefox Add-ons" icon="firefox-browser" href="https://addons.mozilla.org/addon/gmail-alias-toolkit">
    Cài bản Firefox đã ký và nhận cập nhật tiện ích bình thường.
  </Card>

  <Card title="Microsoft Edge" icon="edge" href="https://github.com/ePlus-DEV/gmail-alias-toolkit/releases/latest">
    Tải gói Edge từ bản phát hành GitHub mới nhất.
  </Card>

  <Card title="Opera và trình duyệt Chromium khác" icon="globe" href="https://github.com/ePlus-DEV/gmail-alias-toolkit/releases/latest">
    Tải gói Opera hoặc Chrome phù hợp từ GitHub Releases.
  </Card>
</CardGroup>

## Cài gói phát hành thủ công

Tải đúng gói từ [bản phát hành mới nhất](https://github.com/ePlus-DEV/gmail-alias-toolkit/releases/latest):

| Gói                                         | Trình duyệt                    |
| ------------------------------------------- | ------------------------------ |
| `gmail-alias-toolkit-{version}-chrome.zip`  | Chrome và trình duyệt Chromium |
| `gmail-alias-toolkit-{version}-edge.zip`    | Microsoft Edge                 |
| `gmail-alias-toolkit-{version}-opera.zip`   | Opera                          |
| `gmail-alias-toolkit-{version}-firefox.zip` | Kiểm thử/cài tạm trên Firefox  |

### Chrome, Edge, Opera và Chromium

<Steps>
  <Step title="Tải và giải nén">
    Giải nén file ZIP và lưu thư mục tại vị trí cố định. Có thể đổi tên thành `gmail-alias-toolkit` để cập nhật thủ công dễ hơn.
  </Step>

  <Step title="Mở trang quản lý tiện ích">
    Truy cập `chrome://extensions`, `edge://extensions` hoặc `opera://extensions` tùy trình duyệt.
  </Step>

  <Step title="Bật chế độ nhà phát triển">
    Bật **Developer mode** trên trang tiện ích.
  </Step>

  <Step title="Nạp tiện ích">
    Chọn **Load unpacked**, sau đó chọn thư mục `gmail-alias-toolkit` đã giải nén.
  </Step>
</Steps>

<Warning>
  Tiện ích được nạp thủ công không tự cập nhật. Không xóa hoặc di chuyển thư mục sau khi cài, nếu không trình duyệt có thể vô hiệu hóa tiện ích.
</Warning>

### Cài tạm trên Firefox

<Steps>
  <Step title="Giải nén gói Firefox">
    Tải và giải nén `gmail-alias-toolkit-{version}-firefox.zip`.
  </Step>

  <Step title="Mở trang gỡ lỗi Firefox">
    Truy cập `about:debugging#/runtime/this-firefox` và chọn **Load Temporary Add-on**.
  </Step>

  <Step title="Chọn manifest">
    Chọn file `manifest.json` trong thư mục đã giải nén.
  </Step>
</Steps>

<Note>
  Tiện ích Firefox dạng tạm sẽ bị gỡ khi khởi động lại Firefox. Nên dùng bản đã ký trên Firefox Add-ons cho nhu cầu hằng ngày.
</Note>

## Build từ mã nguồn

**Yêu cầu:** Node.js 24 trở lên và Corepack/Yarn.

```bash theme={null}
git clone https://github.com/ePlus-DEV/gmail-alias-toolkit.git
cd gmail-alias-toolkit
corepack enable
yarn install

# Build Chrome/Chromium
yarn build

# Tùy chọn: build Firefox
yarn build:firefox
```

Với Chrome hoặc Chromium, nạp thư mục `.output/chrome-mv3`. Xem thêm quy trình phát triển trong [`CONTRIBUTING.md`](https://github.com/ePlus-DEV/gmail-alias-toolkit/blob/main/CONTRIBUTING.md).

## Cập nhật bản cài thủ công

<Steps>
  <Step title="Tải gói mới">
    Tải và giải nén gói mới nhất dành cho cùng trình duyệt.
  </Step>

  <Step title="Thay nội dung thư mục cũ">
    Giữ nguyên đường dẫn thư mục tiện ích, xóa nội dung cũ và sao chép nội dung mới vào đó.
  </Step>

  <Step title="Tải lại tiện ích">
    Quay lại trang quản lý tiện ích và chọn **Reload** cho Gmail Alias Toolkit.
  </Step>
</Steps>

Giữ nguyên đường dẫn thư mục giúp trình duyệt duy trì định danh tiện ích và dữ liệu đã lưu cục bộ.


## Related topics

- [Cài đặt](/vi/google-cloud-skills-boost-helper/installation.md)
- [Gmail Alias Toolkit](/vi/gmail-alias-toolkit/introduction.md)
- [Tiện ích trình duyệt ePlus.DEV](/vi/index.md)
- [Google Cloud Skills Boost Helper](/vi/google-cloud-skills-boost-helper/introduction.md)
- [Câu hỏi thường gặp](/vi/google-cloud-skills-boost-helper/faq.md)