本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 VS Code 中使用 Amazon CodeCatalyst 資源
<a name="codecatalyst-overview"></a>

下列各節提供可從 Toolkit for VS Code 取得的 Amazon CodeCatalyst 資源管理功能的概觀。

如需有關開發環境以及如何從 CodeCatalyst 存取這些環境的詳細資訊，請參閱**《Amazon CodeCatalyst 使用者指南》中的[開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)一節。

下列各節說明如何從 VS 程式碼建立、開啟和使用開發環境。

**Topics**
+ [複製儲存庫](#codecatalyst-overview-clone)
+ [開啟開發環境](#codecatalyst-overview-open)
+ [建立 CodeCatalyst 開發環境](#codecatalyst-overview-create)
+ [從第三方儲存庫建立開發環境](#codecatalyst-devenvironment-link-repo)
+ [VS Code 中的 CodeCatalyst 命令](#codecatalyst-overview-commands)

## 複製儲存庫
<a name="codecatalyst-overview-clone"></a>

CodeCatalyst 是以雲端為基礎的服務，需要您連線到雲端才能處理 CodeCatalyst 專案。如果您偏好在本機處理專案，您可以將 CodeCatalyst 儲存庫複製到本機機器，並在下次連線至雲端時，將其與線上 CodeCatalyst 專案同步。

若要使用 AWS Toolkit 將儲存庫從 CodeCatalyst 帳戶複製到 VS 程式碼，請完成下列步驟：

**注意**  
如果您要從第三方服務複製儲存庫，系統可能會提示您使用該服務的登入資料進行身分驗證。  
複製儲存庫時，VS 程式碼會在**複製儲存庫**狀態視窗中顯示進度。複製儲存庫之後，會顯示**您要開啟複製的儲存庫嗎？**訊息。

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 展開 **CodeCatalyst**，選擇**複製儲存庫**。

1. 從**選取 CodeCatalyst 儲存庫**對話方塊中，搜尋您要複製的儲存庫，然後選取它以開啟**選擇要複製的資料夾**對話方塊。

1. 選擇**選取儲存庫位置**以關閉提示，並開始複製儲存庫。

1. 從對話方塊視窗中，選擇下列其中一項以完成複製程序：
   + 若要在目前的 VS 程式碼視窗中開啟儲存庫，請選擇**開啟**。
   + 若要在新的 VS 程式碼視窗中開啟您的儲存庫，請選擇**在新視窗中開啟**。
   + 若要在不開啟儲存庫的情況下完成複製程序，請關閉對話方塊視窗。

## 開啟開發環境
<a name="codecatalyst-overview-open"></a>

若要在 VS 程式碼中開啟現有的開發環境，請完成下列步驟。

**注意**  
選取開發環境會開啟開發環境，以開始將 VS 程式碼與 CodeCatalyst 連線的程序。在此過程中，VS Code 會在 CodeCatalyst 狀態視窗中顯示進度更新。當程序完成時，狀態視窗會更新。  
如果開發環境無法開啟，狀態會更新為 程序失敗原因的相關資訊，以及開啟程序日誌的連結。
如果程序成功，您的開發環境會從 VS 程式碼在新視窗中開啟。

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 展開 **CodeCatalyst** 並選擇**開啟開發環境**，以在 VS 程式碼中開啟**選取 CodeCatalyst 開發環境**對話方塊。

1. 從**選取 CodeCatalyst 開發環境**對話方塊中，選擇您要開啟的**開發環境**。

## 建立 CodeCatalyst 開發環境
<a name="codecatalyst-overview-create"></a>

若要建立新的開發環境，請完成下列步驟：

**注意**  
建立新的開發環境時，請注意下列事項：  
AWS 建議您指定別名，因為它可簡化組織並改善開發環境的搜尋功能。
開發環境會持續儲存您的工作。這表示您的開發環境可以停止，而不會遺失您的工作。停止開發環境可降低讓開發環境保持正常運作所需的成本。
**儲存**是建立開發環境後無法變更的唯一設定。
VS 程式碼會顯示您的開發環境在狀態視窗中建立的進度。建立開發環境後，VS 程式碼會在新視窗中開啟開發環境，而**您是否信任此資料夾中檔案的作者？**提示也會出現。同意條款與條件，以繼續在您的開發環境中運作。

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 展開 **CodeCatalyst**，然後選擇**建立開發環境**選項，以在 VS 程式碼中開啟**建立 CodeCatalyst 開發環境**選單。

1. 從**來源碼**區段中，選擇下列其中一個選項：
   + **使用現有的 CodeCatalyst 儲存庫**：從現有的 CodeCatalyst 儲存庫建立開發環境。您必須選取 CodeCatalyst **專案**和**分支**。
   + **建立空的開發環境**：建立空的開發環境。

1. （選用） 從**別名**區段中，輸入開發環境的備用名稱。

1. （選用） 從**開發環境組態**區段中，變更下列設定以符合您的特定需求。
   + **運算**：選擇**編輯運算**以變更指派給系統的處理能力和 RAM 數量。
   + **逾時**：選擇**編輯逾時**以變更開發環境停止之前允許的系統閒置時間量。
   + **儲存**：選擇**編輯儲存體大小**，以變更指派給系統的儲存空間量。

1. 選擇**建立開發環境**以建立新的雲端開發環境。

## 從第三方儲存庫建立開發環境
<a name="codecatalyst-devenvironment-link-repo"></a>

您可以透過連結至儲存庫做為來源，從第三方儲存庫建立開發環境。

連結到第三方存儲庫做為來源的作業，是在 CodeCatalyst 中的專案層級處理。如需如何將第三方存儲庫連線到開發環境的說明和其他詳細資訊，請參閱《Amazon CodeCatalyst 使用者指南》**中的[連結來源儲存庫](https://docs.aws.amazon.com//codecatalyst/latest/userguide/source-repositories-link.html)主題。

## VS Code 中的 CodeCatalyst 命令
<a name="codecatalyst-overview-commands"></a>

還有其他 VS Code 命令會指派給 CodeCatalyst 相關功能，這些功能不會直接顯示在 AWS Toolkit 中。

若要從命令調色盤檢視指派給 CodeCatalyst 的命令清單，請完成下列步驟：

1. 從 Toolkit for VS Code 中，展開 **DEVELOPER TOOLS** 瀏覽器。

1. 選擇**顯示 CodeCatalyst 命令**以開啟**命令調色盤**，其中包含 的預先填入搜尋`CodeCatalyst`。

1. 從清單中選擇 CodeCatalyst 命令以啟用它。