元件庫

在關於建立元件的 概覽 文章中,你會了解 canvas 應用程式中的元件。 當你在應用程式內建立元件時,也可以建立一個元件庫,供你重複使用。 透過建立元件庫,應用程式製作者能輕鬆與其他創作者分享並更新一個或多個元件。

元件庫是元件定義的容器,可讓您輕鬆地:

  • 探索並搜尋元件。
  • 發佈更新。
  • 將可用元件更新通知應用程式提供者。

附註

元件程式庫是跨應用程式重複使用元件的建議方式。 使用元件庫時,應用程式會維持其使用的元件依從性。 當相依元件的更新可用時,應用程式製作者會收到通知。 因此,在元件函式庫中建立可重複使用的元件。 允許將元件從一個畫布應用程式匯入至另一個畫布應用程式的先前 Power Apps 功能已停用。

應用程式與元件庫之間的區別

元件庫提供使用者集中和管理的元件存放庫,以便重複使用。

如果您建立元件程式庫,則左側導覽的 Insert 窗格預設為元件索引標籤。 當您建立應用程式時,此視圖會顯示畫面而不是元件。

附註

元件函式庫中的螢幕僅供測試使用。 它讓程式庫開發人員可以在實際螢幕上快速測試所建立的元件,並在元件隨時間持續改進時驗證其更新行為。 若要使用元件庫中的元件,您必須建立使用元件程式庫的應用程式。

你可以使用元件庫中畫面的播放選項來預覽元件庫元件。 當您選取元件索引標籤時,會停用播放選項。 當使用 Power Apps Mobile 時,無法顯示元件庫。

附註

本文討論的元件庫與 Power Apps component framework 不同,後者讓開發人員和決策者為模型導向及畫布應用程式建立程式碼元件。 欲了解更多資訊,請參閱 Power Apps 元件框架概述。

使用元件程式庫

您可以從相同介面建立新的元件程式庫或編輯現有的元件程式庫。 請移至Power Apps>從左側瀏覽中選取更多>選取探索全部>從應用程式增強部分選取元件程式庫。 您也可以將元件程式庫 選項釘選到 Power Apps 介面。 更多資訊請參閱 Power Apps 中的左側導覽。

建立範例元件程式庫

在元件庫中建立元件的步驟與應用程式中建立元件的步驟相同。 您將建立元件庫,然後重複使用從 元件總覽範例 建立元件的步驟。 接著你用元件函式庫在新應用程式中提供可重複使用的元件。

  1. 登入 Power Apps。

  2. 在左側瀏覽中選取元件程式庫,然後選取新的元件程式庫。 或者,如果你在左側導覽中看不到元件函式庫,從左側導覽選擇「更多」,點選「全部發現」按鈕,然後從應用程式增強區塊選擇元件函式庫。

  3. 元件函式庫名稱 為 Menu components;或者提供你選擇的其他名字。

  4. 按照步驟從 元件總覽範例 建立元件。 你不需要打開 Power Apps Studio 或建立新的空白應用程式,因為你已經建立了新的元件函式庫。 開始步驟 2。

    完成建立元件的步驟後,請接著依照下一組步驟 將元件新增至畫面,並依照相關步驟 建立輸出屬性。

  5. 完成元件建立與測試後,請從應用程式動作中選擇 儲存 圖示,儲存元件庫。

    你也可以在儲存圖示旁的箭頭選單中,選擇使用版本備註儲存。 版本附註對檢索元件庫的版本很管用,也可從此元件庫升級應用程式中使用的元件。 想了解更多關於應用程式動作的細節,請參閱《了解 Power Apps Studio》文章。

    儲存元件庫時的版本附註。

    提示

    版本附註有助於檢閱元件庫的各個版本,也能協助使用您元件庫的應用程式製作者檢閱變更,並視需要更新使用這些元件的應用程式。 前往 更新元件庫 取得更多詳細資料。

  6. 你可以發佈一個已儲存的元件函式庫。 使用元件庫的應用程式只能使用已發佈的元件庫更新。 從應用程式動作中選擇 發佈 圖示以發布元件庫版本:

    發佈元件庫版本。

程式庫元件自訂

當你在元件函式庫中建立元件時,可以設定使用元件庫元件的應用程式是否能自訂該元件。 預設情況下,這個設定在元件屬性中是 開啟 的。 將此設定設為關閉,即可移除在其他應用程式中自訂該元件的功能。

允許在應用程式使用時自訂此元件的選項。

當你新增一個允許自訂的元件時,你會看到一個可以編輯這個元件以增加自訂的選項。 應用程式會製作本地副本,你可以對本地元件副本做修改。 編輯元件後,與元件庫的關聯會被移除。

編輯允許自訂的元件。

選取編輯元件會提示您在本機複製元件以進行自訂。

如果你不允許自訂元件,消費應用程式就不會顯示編輯元件的選項。

沒有可以在使用應用程式內編輯元件的選項。

在此案例中,唯一編輯元件的方法是編輯儲存元件的元件庫。

從元件庫匯入

建立並發佈元件函式庫後,應用程式可以透過匯入該元件庫來使用元件庫。 您也可以 分享元件庫。

若要從元件庫匯入,請編輯現有的應用程式或建立新的應用程式。 在畫布應用程式工作室中開啟應用程式後,請選取插入或左側導覽列中的 +。 然後選取 Get more components 列出目前環境中可用的元件程式庫:

取得更多元件。

你會在螢幕右側看到目前環境中可用的元件函式庫清單。 從元件庫選取個別元件。 或者使用 Select all 一次匯入庫中的所有元件:

匯入元件。

附註

如果製作者在匯入區段中看不到該元件庫,請確認該元件庫已與該製作者共用。 更多細節請參閱元件函式庫權限。

附註

你可以選擇並匯入多個元件,並且跨越不同的元件函式庫。

應用程式中可用的元件會列在 Insert 窗格中元件清單的 Custom 類別下。 匯入元件庫的可用元件會列在 Library components 類別下:

將元件插入應用程式。

更新元件庫

您可以修改現有的元件程式庫,並使用其他版本說明儲存任何變更。 但是更新的元件庫版本必須發佈,才能在使用元件庫的現有應用程式中使用。 範例元件函式庫步驟說明了儲存元件庫後如何發佈。

使用程式庫元件的應用程式有兩種方式可取得最新變更。

方法 1:應用程式編輯時的元件更新通知

其他應用程式的開發商會在更新元件可用時收到通知。 當製作者在畫布應用程式工作室中編輯應用程式時,便會顯示此通知。 他們可以選擇更新元件:

有可用的更新。

選擇 「審查」,你會看到更新元件的選項:

更新元件。

你在發佈元件函式庫版本時新增的版本說明會顯示在這裡。

選取 Update 更新元件。

方法 2:主動式檢查是否有更新

用這個方法在 Studio 開發時主動檢查應用程式更新。

要做這個檢查,請在左側選擇 「插入元件 」面板,然後選擇 「檢查更新」 圖示。

檢查最新元件

如果函式庫中元件有更新,你會收到訊息,要求你檢視並取得最新變更。 當你檢視並更新時,應用程式會更新到最新的元件。

在取用應用程式中從元件庫更新元件

如果您從元件程式庫匯入元件,就無法在使用的應用程式中編輯元件。 如果你選擇 編輯元件,你會看到一個選項可以在目前應用程式中建立元件的副本,以便你進行修改:

編輯程式庫元件。

如果您選取 Create a copy,元件會複製到本機應用程式。 元件的本機拷貝版會出現在 Insert 窗格中 Custom 類別下。 如果後來發佈原始元件函式庫的新版本,這個元件的本地副本將不會收到更新。

附註

在你建立元件本地副本後,元件庫中正在使用的元件實例不會受到影響,並且會持續連結到元件庫的定義。 只有已在本機複製的元件(來自 自訂 類別)的執行個體,才會被視為本機應用程式元件。

刪除元件程式庫

如果畫布應用程式參考了元件程式庫,則無法將其刪除。 此情況適用於 Power Platform 與非 Power Platform 環境。 在刪除程式庫之前,先從應用程式移除該元件。 您可以在解決方案相依性檢視表或嘗試刪除程式庫時顯示的訊息中,找到有關使用元件程式庫的應用程式的訊息。

刪除程式庫元件。

元件程式庫權限

共用元件程式庫的方式與您共用畫布應用程式的方式相同。 當您共用元件庫時,您可以允許其他人重複使用元件庫。 在共用之後,其他人就可以編輯元件庫,並從此共用元件庫匯入元件,以建立和編輯應用程式。 如果共用為共同擁有者,則使用者可以使用、編輯及共用元件程式庫,但不會刪除或變更擁有者。

將元件庫共用給安全性群組時的其他注意事項:

  • 共用作為解決方案一部分建立的元件庫時,您無法使用共用介面。 請改用 Set-PowerAppRoleAssignment Cmdlet 和 CanEdit 權限等級,將元件庫與所選安全性群組共用。
  • 在沒有 Dataverse 資料庫的 Power Platform 環境中建立,並以共同擁有者身分共用的元件庫,會自動將CanEdit權限授予所選的安全性群組。

已知限制

  • 已知適用於元件的限制同樣適用於元件函式庫。

  • 您無法從本機儲存的元件庫中匯入元件。 你可以透過應用程式動作中的 「下載一份副本 」來下載元件函式庫。 但如果你嘗試匯入那個已儲存的元件庫,你會看到以下錯誤訊息:

    匯入元件程式庫檔案。

  • 如果是第一次在環境中匯入應用程式及元件程式庫,請確定應用程式使用元件程式庫中包含的最新版本元件。 否則,應用程式匯入後不會收到更新。 應用程式會在後續元件函式庫匯入相同環境時辨識並提示更新版本。

  • 元件程式庫中不支援程式碼元件。

另請參閱