環境
標籤環境會定義您在網站或應用程式上部署的程式庫組建的數種關鍵面向:
- 組建的檔案名稱。
- 組建的網域和路徑 (取決於環境的指派主機)。
- 組建的檔案格式 (取決於選擇的封存方法)。
建立程式庫組建時,必須將其指派至一個環境。 隨後組建的擴充功能、規則和資料元素會經過編譯,並放入指派的環境中。每個環境都會提供唯一的內嵌程式碼,可讓您將指派的組建整合至您的網站。
每個環境中都可能存在不同的成品。 這可讓您透過工作流程推送不同的程式庫,藉此在不同環境中測試這些程式庫。
本檔案提供如何在資料收集使用者介面中安裝、設定和建立不同環境的步驟。
環境類型
標籤支援三種不同的環境型別,分別對應至發佈工作流程中的不同狀態:
每個環境中都可能存在不同的成品。 這可讓您隨著在發佈工作流程推進程式庫,藉此在不同環境中測試不同程式庫。
安裝 installation
每個環境都有一組用來與應用程式連接的指示。針對 Web 屬性,這些指示會提供內嵌程式碼。針對行動屬性,這些指示會提供必要的程式碼,用於將使用中的程式庫實例化,以及在執行階段擷取設定。
若要存取環境的安裝指示,請瀏覽至您屬性的「環境」標籤,然後選取該環境的「安裝」圖示。
如果使用 Web 屬性,您會獲得要在文件的 <head>
標記中使用的內嵌程式碼。此外,您可以選擇在執行階段要以同步或非同步方式部署程式庫檔案。系統會根據您選擇的設定,顯示不同的安裝指示。本文件稍後將詳細說明內嵌程式碼。
如果您使用行動屬性,系統則會針對 Android (透過 Gradle) 和 iOS (透過 CocoaPods) 安裝相依性提供不同指示。
行動設定
如需設定行動屬性,您可從清單中選擇相關選項,查看環境所適用的設定選項。您可以在這裡變更環境名稱。行動環境目前只能使用 Adobe 管理的主機。
如需詳細資訊,請參閱主機的相關概述。
Web 設定
指派環境中的設定會決定Web屬性的下列專案:
- 主機:您要部署組建的伺服器位置。
- 封存設定:系統應輸出一組可部署的檔案,或是將這些檔案壓縮為封存格式。
- 內嵌程式碼:要在網站頁面的 HTML 中嵌入的
<script>
程式碼,用於在執行階段部署程式庫組建。
在環境索引標籤中,選取列出的環境以顯示其設定控制項。
Host host
選取 主機,從下拉式功能表中選擇為環境預先設定的主機。
建立組建時,該組建會傳送至您為指派主機指定的位置。 有關如何建立及設定標籤主機的資訊,請參閱主機概觀。
封存設定 archive
大部分的組建都包含多個檔案。多檔案組建包含一個主要程式庫檔案 (在內嵌程式碼中連結),其中包含其他隨需提取檔案的內部參照。
建立封存 按鈕可讓您切換環境的封存設定。 封存選項預設為關閉,而組建會以原樣執行的格式傳送 (Web 屬性為 JavaScript,行動屬性為 JSON)。
如果您選擇開啟封存設定,UI 中會顯示其他設定,讓您選擇性加密封存檔案,並定義程式庫的路徑 (如果您使用自行託管)。
路徑可以是完整的 URL,或是可跨多個網域使用的相對路徑。這很重要,因為大部分的組建都具有包含內部參照的多個檔案。
如果您使用封存選項,所有組建檔案都會改以 ZIP 檔案傳送。這在下列情況中相當實用:
- 您自行託管程式庫,但不想設定 SFTP 主機用於傳送。
- 部署之前,您需要對組建進行程式碼分析。
- 您只想查看組建包含的內容。
內嵌程式碼 embed-code
內嵌程式碼是必須放置在網站頁面<head>
區段中的<script>
標籤,這樣才能載入並執行您建置的程式碼。 每個環境設定都會自動產生各自的內嵌程式碼,因此您只需加以複製並貼到要執行標籤的網站頁面上。
當您檢視安裝指示時,您可以選擇讓指令碼以同步或非同步方式載入程式庫檔案。此設定不具持續性,也不會反映您實際在網站上實作標籤的方式。 目的只是為了顯示安裝環境的適當方法。
非同步部署
非同步部署可讓瀏覽器在擷取程式庫時繼續載入頁面其餘部分。使用此設定時,只有一段內嵌程式碼,必須放在文件 <head>
中。
如需此設定的詳細資訊,請參閱非同步部署的指南。
同步部署
瀏覽器使用同步部署讀取內嵌程式碼時,會擷取並執行標籤程式庫,再繼續載入頁面。
同步內嵌程式碼有兩個必須放置在網站 HTML 中的 <script>
標記。一個 <script>
標記必須放在文件 <head>
中,另一個標記則必須放在結束 </body>
標記之前。
內嵌程式碼更新
由於內嵌程式碼是根據您的環境設定而產生,因此某些設定變更會自動更新相關環境的內嵌程式碼。這些變更包括:
- 從 Adobe 管理主機切換至 SFTP 主機 (反之亦然)。
- 變更封存設定。
- 更新路徑欄位 (如果已啟用封存設定)。
建立環境
首次建立屬性時,系統會自動將三個環境指派給屬性:開發、預備和生產。這三種環境足以執行發佈工作流程。不過,您可視需要新增其他開發環境,因為這對同時有多位開發人員處理不同專案的大型團隊非常有用。
在您的屬性的環境索引標籤上,選取 新增環境。
在下一個畫面中,選取 開發 選項。
下一個畫面可讓您為新環境命名、選取主機,以及選擇封存設定。完成後,選取 儲存 以建立環境。
環境索引標籤會重新出現,並顯示新環境的安裝指示。
後續步驟
閱讀本文件後,您應該已經實際了解如何在 UI 中設定環境,並且將環境安裝至您的網站或應用程式中。您現在可以開始發佈程式庫組建。
當您隨著時間推移發佈程式庫的反覆項目時,可能會發現必須追蹤並封存舊版組建,以便疑難排解和復原。如需詳細資訊,請參閱重新發佈舊版程式庫的指南。