使用 Sharpen 將 Java 專案自動轉換為 C# 專案：Eclipse 插件完整安裝與操作指南

什麼是 Sharpen？

Sharpen 是 db4o 開源的 Java-to-C# 翻譯工具，基於 Eclipse JDT AST 解析 Java 原始碼並產出對等 C# 程式碼。支援語法對應、集合轉換、異常處理、泛型等核心語言特性。

前置需求

• Eclipse / MyEclipse (範例用 MyEclipse 6.5)
• Eclipse SVN 插件 (Subversive 或 Subclipse)
• JDK 1.5+ (對應 file.jvm.jdk1.5 路徑)

安裝步驟

1. 檢出 Sharpen 原始碼：從 https://source.db4o.com/db4o/trunk/sharpen 以 SVN 檢出 4 個專案（sharpen.core, sharpen.ui, sharpen.tests, sharpen.ant）至**同一工作區**。
2. 匯出為 Eclipse 外掛：右鍵專案 → Export → Deployable plug-ins and fragments → 目的地選 **Eclipse 根目錄**（MyEclipse 亦同）。
3. 重新啟動 Eclipse，外掛即載入完成。

專案轉換配置

在待轉換的 Java 專案根目錄新增兩個檔案：

1. sharpen.properties

# eclipse workspace
dir.workspace=C:/Documents and Settings/Administrator/桌面/paoding
# java executable
file.jvm.jdk1.5=D:/Java/jdk1.5.0/bin/java.exe
# Eclipse home directory
eclipse.home=D:/Java/MyEclipse 6.5/eclipse
# Eclipse startup jar
eclipse.startup.jar=${eclipse.home}/plugins/org.eclipse.equinox.launcher_1.0.0.v20070606.jar
# sharpen compile directory
dir.dist.classes.sharp=dist/sharpen
# Eclipse plugins home
plugins.home=${eclipse.home}/plugins

請依實際環境修改路徑（workspace、JDK、Eclipse 根目錄）。

2. Sharpen-Common.xml (Ant 建置腳本)

<project name="sharpen common">
  <property file="sharpen.properties" />
  <macrodef name="reset-dir">
    <attribute name="dir" />
    <sequential>
      <delete dir="@{dir}" />
      <mkdir dir="@{dir}" />
    </sequential>
  </macrodef>
  <macrodef name="sharpen">
    <attribute name="workspace" />
    <attribute name="resource" />
    <element name="args" optional="yes" />
    <sequential>
      <exec executable="${file.jvm.jdk1.5}" failonerror="true" timeout="1800000">
        <arg value="-Xms256m" />
        <arg value="-Xmx512m" />
        <arg value="-cp" />
        <arg value="${eclipse.startup.jar}" />
        <arg value="org.eclipse.core.launcher.Main" />
        <arg value="-data" />
        <arg file="@{workspace}" />
        <arg value="-application" />
        <arg value="sharpen.core.application" />
        <arg value="-header" />
        <arg file="config/copyright_comment.txt" />
        <arg value="@{resource}" />
        <args />
      </exec>
    </sequential>
  </macrodef>
  <target name="install-sharpen-plugin">
    <property name="sharpen.core.dir" location="../sharpen.core" />
    <reset-dir dir="${dir.dist.classes.sharp}" />
    <javac fork="true" debug="true" target="1.5" source="1.5"
         destdir="${dir.dist.classes.sharp}" srcdir="${sharpen.core.dir}/src"
         encoding="UTF-8">
      <classpath>
        <fileset dir="${eclipse.home}/plugins">
          <include name="org.eclipse.osgi_*/osgi.jar" />
          <include name="org.eclipse.core.resources_*/resources.jar" />
          <include name="org.eclipse.core.runtime_*/runtime.jar" />
          <include name="org.eclipse.jdt.core_*/jdtcore.jar" />
          <!-- redundant entries for newer eclipse -->
          <include name="org.eclipse.osgi_*.jar" />
          <include name="org.eclipse.core.resources_*.jar" />
          <include name="org.eclipse.core.runtime_*.jar" />
          <include name="org.eclipse.jdt.core_*.jar" />
          <include name="org.eclipse.jdt.launching_*.jar" />
          <include name="org.eclipse.equinox.*.jar" />
          <include name="org.eclipse.core.jobs_*.jar" />
        </fileset>
      </classpath>
    </javac>
    <property name="plugin.dir" value="${plugins.home}/sharpen.core_1.0.0" />
    <reset-dir dir="${plugin.dir}" />
    <jar destfile="${plugin.dir}/sharpen.jar" basedir="${dir.dist.classes.sharp}" />
    <copy todir="${plugin.dir}" file="${sharpen.core.dir}/plugin.xml" />
  </target>
</project>

執行轉換

1. 在 Eclipse 中開啟 Ant View，拖入 Sharpen-Common.xml。
2. 右鍵 install-sharpen-plugin 目標 → Run As → Ant Build（確保 Sharpen 外掛已安裝）。
3. 再執行 sharpen 巨集，參數指定 workspace 與要轉換的專案/資源路徑。
4. 轉換後的 C# 程式碼將輸出至 dist/sharpen 目錄。

專案結構示意

注意事項與限制

• Sharpen 專注於**語法層面轉換**，不處理執行階段庫差異（如 Java NIO vs .NET Streams、Swing vs WinForms/WPF）。
• 複雜專案轉換後需人工修正：第三方庫對應、設定檔、建置腳本、測試碼。
• 建議採用**增量遷移策略**：核心領域模型優先轉換，外圍逐步重寫或找替代庫。
• 現代替代方案：Microsoft Java Language Conversion Assistant (JLCA) (舊)、手動重寫 + 介面契約測試、跨語言微服務共存。

結語

Sharpen 為大型 Java 遷移 .NET 提供了自動化起點。掌握其安裝配置流程，能在評估遷移可行性、建立初版 C# 碼庫時節省大量人力。但記住：自動轉換只是開始，架構對齊與測試驗證才是成功關鍵。