使用應用程式探索助理來建立應用程式和專案

AppScan® 包含功能強大的應用程式探索助理,可讓您為 Java 原始碼Microsoft Visual Studio 解決方案快速建立及配置應用程式和專案。應用程式探索助理 也可讓您尋找包含 Java 專案的 Eclipse 工作區。應用程式探索助理 可讓您指向原始碼、解決方案或工作區目錄,然後交由 AppScan® 處理其餘工作。

執行這項作業的原因和時機

您可以使用 應用程式探索助理 來搜尋包含 Java 原始碼Microsoft Visual Studio 解決方案及/或 Eclipse 工作區組合的位置。應用程式探索助理 的最終畫面可讓您指定僅限 Java 的應用程式/專案結構喜好設定。這個畫面與 Microsoft Visual Studio 解決方案或 Eclipse 工作區的應用程式及專案檔位置沒有關聯,應用程式檔案會自動放在解決方案或工作區的根目錄,專案檔會自動放在個別解決方案或工作區專案的根目錄。

程序

  1. 完成下列其中一個動作來啟動應用程式探索助理
    • 從主功能表列中,選取檔案 > 新增應用程式 > 探索應用程式
    • 在「瀏覽器」視圖的快速入門區段中,選取探索應用程式
    • 在「瀏覽器」視圖工具列中,按一下新增應用程式功能表向下箭頭按鈕,然後從功能表中選取探索應用程式
    • 在「瀏覽器」視圖中,用滑鼠右鍵按一下所有應用程式,然後從功能表中選取新增應用程式 > 探索應用程式
  2. 在「搜尋位置」畫面中,指定其中包含您要掃描的原始碼、解決方案或工作區的位置。此外,您也可以設定完成應用程式探索之後立即開始掃描。

    從這裡,您可以按下一步來設定其他應用程式探索助理選項(例如,外部相依關係規格、排除規則及 Java 應用程式/專案結構喜好設定),或可按一下開始,開始應用程式探索。如果您按一下開始

    • 不會設定外部相依關係位置。如果應用程式有外部相依關係,但未指定,則會對掃描結果造成不良影響。
    • 將使用預設排除規則(如需預設規則清單,請參閱預設應用程式探索助理排除規則)。
    • 如果您要尋找 Java 來源,則會建立一個專案和應用程式(單一專案包含找到的所有原始碼根目錄)。

    如果您按下一步,則會繼續到下一步。

  3. 在「外部相依關係」畫面中,設定應用程式具有的每一個外部相依關係的路徑(例如,JDK 或 Web 伺服器的路徑)。請遵循下列指示來完成這個畫面:
    1. 如果要新增外部相依關係,請在表格內按一下,或按一下新增,然後輸入或瀏覽外部相依關係路徑。如果要透過鍵盤來接受輸入的路徑,請按鍵盤的 Enter 鍵。
      提示: 在編輯相依關係路徑欄位時輸入,將會列出可供您選取的目錄。您至少必須輸入一個磁碟機代號。對於指定的路徑,將會列出其中包含的所有資料夾。
    2. 如果要移除外部相依關係路徑,請選取它並按一下刪除
    3. 如果要修改外部相依關係路徑,請在路徑內按一下,然後輸入或瀏覽外部相依關係路徑。

    從這裡,您可以按下一步來設定其他應用程式探索助理選項,或可按一下開始,開始應用程式探索。如果您按一下開始

    • 將使用預設排除規則(如需預設規則清單,請參閱預設應用程式探索助理排除規則)。
    • 如果您要尋找 Java 來源,則會建立一個專案和應用程式(單一專案包含找到的所有原始碼根目錄)。

    如果您按下一步,則會繼續到下一步。

  4. 在「排除規則」畫面中,指定濾除檔案和目錄的規則。請以 PERL、Grep、EGrep 或完全相符正規表示式來設定規則。例如,如果您要在 應用程式探索 搜尋時排除名為 temp 的目錄,您可以新增 PERL .*[\\/]temp 排除規則。

    依預設,會提供一組 PERL 正規表示式來排除一些共用目錄(如需完整清單,請參閱預設應用程式探索助理排除規則)。如果要修改這份清單或建立新的規則,請遵循下列指示:

    1. 如果要修改現有的排除規則,請在規則內按一下以啟動規則編輯器。一旦您已完成規則的編輯,請按一下離開,或按鍵盤 Enter 鍵。

      如果要修改現有規則的正規表示式類型,請在規則的正規表示式類型資料格內按一下,然後從功能表中選取正規表示式類型。

    2. 如果要新增排除規則,請按一下新增。這樣會將新的規則新增至表格,您可以遵循上方修改規則的指示來變更此規則。
    3. 如果要移除排除規則,請選取該規則,然後按一下刪除(或按一下全部刪除,以移除畫面中目前所列出的全部排除規則)。
    重要: 表格中以勾號表示有效的排除規則,以紅色 X 表示無效的規則。所有規則必須有效,否則無法啟動應用程式探索或在應用程式探索助理中繼續。

    從這裡:

    • 如果您只是搜尋 Java 來源,您可以按下一步來設定應用程式探索助理應用程式/專案結構喜好設定,或按一下開始來執行助理。
    • 如果您只是搜尋 Microsoft Visual Studio 解決方案或 Eclipse 工作區,按一下開始來執行助理。按下一步時,助理會進入僅適用於 Java 原始碼探索的畫面。

    如果您按下一步,則會繼續到下一步。

  5. 應用程式和專案建立畫面僅適用於 Java 原始碼探索。請在其中指定將建立的應用程式和專案的結構:
    1. 如果要為所有找到的原始碼根目錄建立單一專案,請在專案功能表中選取建立單一專案。這樣選取時,您只能選擇建立單一應用程式。
    2. 如果要為找到的每一個原始碼根目錄建立個別專案,請在專案功能表中選取為發現的每一個原始碼根目錄建立一個專案。這樣選取時,您可以選擇建立一個應用程式或多個應用程式。如果要建立單一應用程式來包含所有建立的專案,請在應用程式功能表中選取建立單一應用程式。如果要為每一個建立的專案建立應用程式,請在應用程式功能表中選取建立每個專案的應用程式

    此外,選擇位置來儲存應用程式及專案定義檔。

    如果您選擇為我組織檔案

    • 如果您建立單一專案,則會在搜尋位置建立專案及應用程式檔案。
    • 如果您在單一應用程式中為每一個原始碼根目錄建立專案,則會在原始碼根目錄的上層目錄中建立每一個原始碼根目錄的專案檔,並且在搜尋位置中建立應用程式檔案。
    • 如果您為每一個原始碼根目錄建立專案,並為每一個專案建立應用程式,則會在原始碼根目錄的上層目錄中建立每一個原始碼根目錄的專案和應用程式檔案。

    如果您指定目錄,則會在該目錄中建立所有應用程式及專案檔。

  6. 如果您要變更先前畫面中所做的任何設定,請按上一步。對 應用程式探索 設定感到滿意時,請按一下開始以掃描搜尋位置來尋找原始碼根目錄。

結果

應用程式探索完成時,由應用程式探索建立的新的應用程式和專案會出現在「瀏覽器」視圖中,即備妥可進行掃描(如果您已設為完成應用程式探索之後立即開始掃描,則會開始掃描)。

如果探索期間發現問題,應用程式探索助理完成時會提供探索報告。例如,如果應用程式還有「外部相依關係」畫面中未指定的其他外部相依關係,則報告會包含警告,指出無法解析外部相依關係。在探索報告中:

  • 按一下完成,建立應用程式和專案。如果選取忽略警告並繼續掃描,則會立即掃描應用程式和專案。
  • 上一步,變更 應用程式探索助理 設定或重新執行 應用程式探索
  • 按一下取消,關閉探索報告而不建立應用程式或專案。