在 Mac 上設定 Oracle Analytics 擴充開發環境

本主題描述設定和使用 Oracle Analytics 擴充開發環境所需執行的作業。

主題：

在 Mac 上安裝 Oracle Analytics Desktop

Oracle Analytics Desktop 提供了建立開發環境和擴充架構以及本機測試環境所需的命令檔。

請安裝或升級至最新版本的 Oracle Analytics Desktop。
請參閱設定 Oracle Analytics 擴充開發環境的工作流程。
  1. 前往 Oracle Analytics Desktop 安裝下載，按一下下載並登入您的 Oracle Cloud 帳戶。
  2. 在 Oracle Software Delivery Cloud 頁面中，按一下平台並選取 Apple Mac OS X。
  3. 檢閱並接受授權合約。按一下 Oracle Analytics Desktop ZIP 檔以進行下載。
  4. 前往您電腦上的下載位置，按一下該 ZIP 檔，然後按一下 Oracle_Analytics_Desktop_<version>_Mac.pkg 並執行安裝。
  5. 瀏覽至 Applications 檔案夾，確認安裝已建立以下應用程式：
    • Oracle Data Visualization for Desktop
    • Oracle Data Visualization for Desktop Configure Python

在 Mac 上安裝 Java JDK

請使用與您的 macOS 和處理器相容的 Java JDK 版本。本章中的所有範例皆使用 Java JDK 8u201 開發。

請參閱設定 Oracle Analytics 擴充開發環境的工作流程。
  1. 開啟終端機並輸入以下命令，檢查是否已安裝 Java JDK。 
    java -version
  2. 若已安裝 Java JDK，請確認它與您的 macOS 和處理器相容。
  3. 如果您需要安裝 Java JDK，請前往 Java SE Development Kit 8u421。
  4. 在表格中，按一下 macOS 頁籤。找出並下載與您的 macOS 和處理器相容的安裝檔。
  5. 找出並執行下載的安裝檔。
  6. 安裝完成後，在終端機中輸入以下命令，確認您選擇的 Java JDK 版本已順利安裝： 
    java -version

在 Mac 上更新 Bash 設定檔或 ZSHRC 檔案並建立開發目錄

請修改您的 bash 設定檔或 ZSHRC 檔案，以在其中包含 Oracle Analytics Desktop 命令檔所需的變數。接著，建立包含開發環境的開發目錄。

請參閱設定 Oracle Analytics 擴充開發環境的工作流程。
  1. 若要修改您的 Bash 設定檔，請前往本位目錄檢查 bash_profile 是否可見。若不可見，請按 Command + Shift + .，讓 bash_profile 變為可見。
    若要修改您的 ZSHRC 檔案，請開啟終端機並執行以下命令：
    open ~/.zshrc
  2. 將以下命令行加到 bash_profile 或 ZSHRC。
    在 PLUGIN_DEV_DIR 中指定開發目錄的位置，例如 /Users/<username>/Documents/dv-custom-plugins。
    export DVDESKTOP_SDK_HOME=/Applications/dvdesktop.app/Contents/Resources/app.nw 

export PLUGIN_DEV_DIR=/Users/<username>/Documents/dv-custom-plugins 

export PATH=${DVDESKTOP_SDK_HOME}/tools/bin:$PATH 

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-1.8.jdk/Contents/Home/
  3. 若為 bash_profile，請開啟終端機並執行以下命令來套用變更： 
    source ~/.bash_profile
    若為 ZSHRC 檔案，請開啟終端機並執行以下命令來套用變更：
    source ~/.zshrc
  4. 若要建立擴充開發目錄，請開啟終端機並執行以下命令：
    mkdir $PLUGIN_DEV_DIR

在 Mac 上建立擴充開發環境

設定 bash 設定檔後，可執行 bicreateenv 命令檔來建立包含建立擴充所需之資源的開發環境。

如需有關執行此命令檔時可用之選項的相關資訊，請參閱命令檔的命令行說明，例如： 
cd $PLUGIN_DEV_DIR
bicreateenv -help
請參閱設定 Oracle Analytics 擴充開發環境的工作流程。
  1. 在 Finder 中，瀏覽至擴充目錄並執行 bicreateenv 命令檔即可建立該環境： 
    cd $PLUGIN_DEV_DIR
bicreateenv
  2. 瀏覽至您建立的目錄並確認其內容如下所示：
    以下為 GUID-68ABA89D-FFB2-44E5-9E68-8B93C9D4EB02-default.png 的說明
    .png

  3. 開啟 build.gradle，搜尋 -pluginDevDir。如果 -pluginDevDir 引數包含大寫字母，請將其變更為小寫字母。修改後的引數應如下所示：
    以下為 GUID-5118C073-B409-4B58-B784-EBBAB347A627-default.png 的說明
    .png

  4. 選擇性的： 如果您是透過 Web 代理主機作業，請開啟 gradle.properties，然後新增指向代理主機的系統特性。
    使用下列範例來設定您的系統特性：
    systemProp.https.proxyHost=www-proxy.somecompany.com
systemProp.https.proxyPort=80
systemProp.https.nonProxyHosts=*.somecompany.com|*.companyaltname.com

在 Mac 上建立架構擴充

使用 bicreateplugin 命令檔建立 Oracle Analytics 擴充架構。

如需執行 bicreateplugin 命令檔時可建立之擴充的相關資訊，請參閱 Oracle Analytics 擴充類型。
執行此命令檔會在您的 PLUGIN_DEV_DIRECTORY 環境中建立一個資料夾。此資料夾包含用於開發擴充的檔案。<extension_name>.js 呈現方法是可以開始編寫程式碼的進入點。
bicreateplugin 命令檔使用下列語法： 
bicreateplugin viz -subType <subtypename> -id <com.company.yourVizName>

其中：

subType 指的是您要建立的視覺化擴充類型。有效值為 basic、dataviz 和 embeddableDataviz。建立工作簿擴充時，請勿包括 subType。

id 是擴充的名稱。您指定的名稱必須遵守以下格式：<com.company.yourVizName>。

  1. 在終端機中，瀏覽至您的擴充開發目錄，執行 bicreateplugin 命令檔。
    此範例顯示如何建立 dataviz 架構擴充：
    bicreateplugin viz -subType dataviz -id com.companyabc.helloviz
    此範例顯示如何建立工作簿架構擴充：
    bicreateplugin workbook -id com.companyabc.helloworkbook
  2. 在 Finder 中，瀏覽至 src/customviz 資料夾，確認已建立名稱為您執行命令檔時所指定之擴充名稱的新資料夾。
    此範例顯示 dataviz 擴充的目錄：
    以下為 GUID-393EBB84-A371-4348-9EB4-A7FF7EC2767C-default.png 的說明
    .png

    本範例顯示工作簿擴充的目錄：
    以下為 GUID-E2C82040-2CA5-44F3-BC23-895069B83923-default.png 的說明
    .png

在 Mac 上測試視覺化和工作簿擴充

您可以使用終端機以 SDK 模式執行 Oracle Analytics Desktop，以測試您的 Oracle Analytics 視覺化和工作簿擴充。以 SDK 模式執行 Oracle Analytics Desktop 會在瀏覽器中開啟 Oracle Analytics Desktop。

如需建立工作簿及新增視覺化至工作簿的相關資訊，請參閱開始建置工作簿和建立視覺化、「建立您的第一個視覺化」教學課程以及「開始使用視覺化」影片。
您必須先組建並封裝工作簿擴充，才能將其上傳至 Oracle Analytics Desktop 進行測試。請參閱組建並封裝擴充。
  1. 在終端機中執行以下命令，以在瀏覽器中叫用 Oracle Analytics Desktop：
    ./gradlew run
  2. 如果您執行此命令之後，Oracle Analytics Desktop 開啟然後關閉，您可以使用 Mac 選單列手動在瀏覽器中開啟 Oracle Analytics Desktop。
    1. 前往 Mac 選單列，找出並按一下 Oracle Analytics Desktop 圖示。
    2. 選取將 URL 複製到剪貼簿。
    3. 在瀏覽器中，貼上複製的 URL，然後按 Enter 鍵。
  3. 若要測試視覺化擴充：
    1. 在 Oracle Analytics Desktop 中，開啟或建立工作簿。
    2. 在工作簿的資料面板中，按一下視覺化並捲動至「視覺化」清單的底部，找出其中包含您已建立之自訂視覺化的「自訂視覺化」區段。
      以下為 GUID-E81FA53D-EBF1-41F6-9577-E4C040AF32EC-default.png 的說明
      .png

  4. 若要測試工作簿擴充：
    1. 在 Oracle Analytics Desktop 中，依序按一下導覽器和主控台。前往「視覺化與共用」區段，然後按一下擴充。
    2. 按一下上傳擴充，然後瀏覽並選取工作簿擴充 ZIP 檔。按一下開啟。
    3. 在 Oracle Analytics Desktop 中，開啟或建立工作簿。
    4. 在工具列中按一下自訂工作簿擴充，以檢視您已上傳至執行處理的工作簿擴充清單。
      以下為 GUID-28A0F171-B811-4FF6-BB35-A4CC538D5C70-default.png 的說明
      .png