Jocky for Eclipse

文章目錄

• 一、前言

http://www.blogjava.net/beansoft/archive/2008/03/26/90748.html

Jocky http://www.operamasks.org/ProjectDetails.jsp?proId=9c89b9f7010d1000e000007cca67bf51

Jocky是金蝶中介軟體技術領袖袁紅崗先生的個人作品（舊有名稱JOC)。原本是方便Apusic 應用伺服器的開發，現在開放出來，供大家自由使用 ... Jocky提供了對IDE Eclipse的支援，同時，也支援在Ant中使用（事實上，在Eclipse中，也是先產生一個ant檔案，然後再編譯).

是挺好用, 編譯後的代碼大部分反編譯出來只有 JVM 指令! 的確是保護系統核心的利器! 支援 JDK 1.5. 可是 Jocky 竟然不開源... 領袖啊!

以下是官方IDE(Apusic IDE)中的詳細說明:

Jocky

Java Obfuscate Compiler Kit  for You

一、前言1.1 什麼是Jocky?

   我們知道，Java是一種跨平台的程式設計語言，其源碼(.java檔案)被編譯成與平台無關的位元組碼(.class檔案)，然後在運行期動態連結。這樣，編譯後的類檔案中將包含有符號表，從而使得Java程式很容易被反編譯。相信每一個Java開發人員，都曾經用過諸如Jad之類的反編譯器，對Java的class 檔案進行反編譯，從而觀察程式的結構與實現細節。如此一來，對於那些需要嚴格進行智慧財產權保護的Java應用，如何有效保護客戶的商業投資，是開發人員經常需要面對的問題。
   於是就出現了Java混淆編譯器，它的作用是打亂class檔案中的符號資訊，從而使反向工程變得非常困難。
   Jocky就是這樣一款優秀的Java混淆編譯器。

1.2 為什麼需要Jocky?

   目前業界有不少商業的甚或是開源的混淆編譯器，但它們普遍存在一些這樣或者那樣的問題。一般而言，現有的混淆器都是對編譯好的 class檔案進行混淆，這樣就需要編譯和混淆兩個步驟。而事實上，並不是所有的符號都需要混淆。如果你開發的是一個類庫，或者某些類需要動態裝載，那些公用API(或者說:那些被publish出來的API)就必須保留符號不變，只有這樣，別人才能使用你的類庫。現有的混淆器提供了GUI或指令碼的方式來對那些需要保留的符號名稱進行配置，但如果程式較大時，配置工作將變得很複雜，而程式一旦修改，配置工作又要重新進行。某些混淆器能夠調整位元組碼的順序，使反編譯更加困難，但筆者經曆過混淆之後的程式運行出錯的情況。
   而Jocky與其它混淆編譯器最大的不同之處在於:它是直接從源碼上做文章，也就是說編譯過程本身就是一個混淆過程。

1.3 Jocky是如何工作的?

   Jocky混淆編譯器是在Sun JDK中提供的Java編譯器(javac)的基礎上完成的，修改了其中的代碼產生過程，對編譯器產生的中間代碼進行混淆，最後再產生class檔案，這樣編譯和混淆只需要一個步驟就可以完成。另外可以在來源程式中插入 符號保留指令 來控制哪些符號需要保留，將混淆過程與開發過程融合在一起，不需要單獨的配置。

1.4 Jocky的作用1.4.1代碼混淆

   如前文所述，混淆編譯是Jocky的首要用途。我們舉一個最簡單的例子，下面的SimpleBean是未經混淆的class檔案通過Jad反編譯以後獲得的源檔案:

public class SimpleBean implements Serializable {
private String name = "myname";
private List myList = null;
  public void SimpleBean() {
myList = new ArrayList(10);
}
  public void foo1() {
myList.add("name");
}
private void foo2() {    
}
private void writeObject(java.io.ObjectOutputStream out)
throws IOException {
}
}

<未混淆的類檔案反編譯後的效果>

   下面是經Jocky混淆過的類檔案，通過Jad反編譯後產生的源檔案:

public class SimpleBean implements Serializable {
private String _$2;
private List _$1;
  public SimpleBean() {
_$2 = "myname";
this;
JVM INSTR new #4   <Class ArrayList>
JVM INSTR dup ;
JVM INSTR swap ;
10;
ArrayList();
_$1;
}  
  public void foo1() {
_$1.add("name");
}
private void _$1() {
}
private void writeObject(ObjectOutputStream objectoutputstream){
throws IOException {
}
}

<Jocky混淆過的類檔案反編譯的效果>

1.4.2 支援將JDK 5.0的文法編譯成能夠在JDK 1.4上啟動並執行類檔案

   JDK 5.0在文法層面上有許多新增特色，能夠為簡化應用的開發帶來一些便利。譬如Generics、Enhanced for Loop以及 Autoboxing/Unboxing等。但另人遺憾的是，倘若利用這些新的文法開發應用，就意味著不能夠在JDK 1.4上運行，而JDK 1.4畢竟是目前最為普及的VM版本。幸運是，Jocky的另一個特色就是:通過參數配置，能夠把用JDK 5.0文法編寫的應用編譯成JDK 1.4上的類檔案版本。我們可以把經過 Jocky編譯的類檔案以UltraEdit開啟，可以發現在第8個位元組上(類檔案的major version)的數值是0x30，即十進位的48，這是JDK 1.4所能夠理解的類檔案版本(JDK 5.0預設編譯的類檔案版本是49)。前提是:應用中不能夠使用JDK 1.4中所沒有的一些API。

二、Jocky的用法2.1 常規用法

   使用Jocky非常簡單，獲得jocky.jar以後，只需要運行java -jar jocky.jar就可以啟動Jocky混淆編譯器，jocky的命令列參數和javac完全相同，但增加了一個新的參數-scramble，它的用法如下：

    -scramble          混淆所有package private或private符號    -scrambleall       混淆所有符號    -scramble:<level>  混淆相應層級的符號     其中<level>指定混淆層級，可以是以下幾種層級：    -scramble:none        不進行混淆    -scramble:private     對所有private存取層級的元素進行混淆    -scramble:package     對所有private或package private元素進行混淆    -scramble:protected   對所有private, package private, protected元素進行混淆    -scramble:public      對所有的元素都進行混淆    -scramble:all         相當於-scramble:public    如果使用-scramble不帶層級參數，則相當於-scramble:package

2.2 Jocky for Ant

    近年來，Ant已經成為Java應用開發中打包工具的事實上的標準。在應用的開發過程中，我們往往都會有一個Ant指令碼，通過該指令碼，能夠對應用進行編譯、打包、發布等一系列過程。因此，Jocky的最佳切入點便是對Ant的支援。
    在Ant中使用Jocky非常簡單：
    1. 將lib/jocky-ant.jar copy至ANT_HOME/lib目錄下。
    2. 在ant指令碼中加入這樣一行代碼，以引入Jocky Task

<taskdef resource="jockytasks/">

    3. 設定Jocky的一些基本屬性，包括: jocky.jar包的位置，以及混淆層級，如下所示:

<jocky jar=" F:/Works2/Jocky/jocky1.0/lib/jocky.jar" enable="true" level="private/">

    4. 當設定jocky的enable屬性為true時，此時，Ant指令碼中的javac編譯命令，便會被自動替換成Jocky編譯器；當設定enable屬性為false時，javac編譯命令將恢複成正常設定，樣本指令碼如下:

<project name="jocky" default="build">

<!-- 引入Jocky Ant Task，要確保jocky-ant.jar位於ANT_HOME/lib目錄下 -->

<taskdef resource="jockytasks"> </taskdef>

<target name="build">

<!-- 設定jocky.jar的位置以及混淆層級，當enable為true時，javac task將被自動替換成Jocky混淆編譯器 -->

<jocky jar=" F:/Works2/Jocky/jocky1.0/lib/jocky.jar" enable=" true" level=" private"> </jocky>

<!-- 下面的編譯，將使用Jocky混淆編譯器 -->

<javac destdir="bin2" debug="on" source="1.5" target="1.4">

<src path="src"></src>

</javac>

<!-- 當enable為false時，javac task將被恢複成正常設定, Jocky編譯器不再起作用 -->

<jocky enable="false"></jocky>

<!-- 下面的編譯，將使用正常的Javac編譯器 -->

<javac destdir="bin3" debug="on" target="1.4">

<src path="src"></src>

</javac>

</target>

</project>

<Jocky的Ant指令碼樣本>

    注意: Jocky for Ant在Ant 1.6.5上開發，推薦使用該版本。

2.3 Jocky for Eclipse

    Jocky提供了Eclipse的外掛程式，從而能夠直接在Eclipse中使用Jocky。
    1. Jocky外掛程式的安裝：
    將Jocky外掛程式安裝至Eclipse中非常簡單，只需要將eclipse/plugins/org.apusic.jocky_1.0.0目錄 copy 至 Eclipse的 plugins目錄即可。或者在Eclipse/links檔案夾中，通過link方式指定Jocky的外掛程式目錄。
    2. 在Eclipse中使用Jocky：
    在Eclipse中使用Jocky也非常簡單，任何一個Java工程，選中工程通過右鍵菜單，都可以出現Jocky的捷徑功能表:

<Jocky在Eclipse中的右鍵菜單>

<Jocky在Eclipse中的屬性設定>

    事實上，在Eclipse中使用Jocky時，Jocky也是首先針對所選工程產生Ant的Build檔案（預設名稱jocky_build.xml），然後再通過Ant完成混淆編譯。
    以下是Jocky在Eclipse中自動產生的Ant Build 檔案樣本：

<project basedir="." default="build" name="jocky.example.jocky">

<property name="jocky.jar" value="f:/EclipseWTP1.0.8/workspace_jdk5_apusicstudio/org.apusic.jocky/jocky.jar"></property>

<property name="jocky.output.dir" value="jocky"></property>

<property name="jocky.scramble.level" value="package"></property>

<property name="target" value="1.4"></property>

<path id="project.classpath">

<pathelement location="bin"></pathelement>

</path>

<target name="init">

<jocky jar="${jocky.jar}" level="${jocky.scramble.level}"></jocky>

<mkdir dir="${jocky.output.dir}"></mkdir>

<mkdir dir="${jocky.output.dir}/bin"></mkdir>

</target>

<target name="clean">

<delete dir="${jocky.output.dir}/bin"></delete>

<delete dir="${jocky.output.dir}"></delete>

</target>

<target depends="init" name="build">

<echo message="${ant.project.name}: ${ant.file}"></echo>

<jocky enable="true"></jocky>

<javac destdir="${jocky.output.dir}/bin" target="${target}">

<src path="src"></src>

<classpath refid="project.classpath"></classpath>

</javac>

</target>

</project>

<Jocky在Eclipse中自動產生的Ant指令碼樣本>

注1：只支援Eclipse 3.1.1及以上版本。
注2：如果在Eclipse中找不到Jocky外掛程式，請刪除 Eclipse安裝目錄/configuration/org.eclipse.update 檔案夾 (Maybe an eclipse bug?)。

2.4 如何使用符號保留指令

   除了在命令列用 -scramble 參數控制符號混淆層級外，還可以在原始碼中使用符號保留指令來控制那些符號需要保留。符號保留指令是一個Java文檔注釋指令，可以插入在類和類成員的文檔注釋中，例如：

/**
* This class should preserve.
* @preserve
*/
public class Foo {
/**
* You can specify which field should be preserved.
* @preserve
*/
private int x;
/**
* This field is not preserved.
*/
private int y;
/**
* You can also preserve methods.
* @preserve
*/
public void hello() {}
/**
* This method is not preserved.
*/
private void collect() {}
}

<使用preserved指令的樣本>

   如果沒有@preserve指令，則根據混淆層級及成員的存取層級來確定符號是否保留。
   對於類的符號保留指令可以附帶一個保留層級參數，來控制類成員的符號保留，包括：

       @preserve            僅對類名進行保留，類成員的保留根據-scramble命令列參數決定       @preserve public     保留所有public成員       @preserve protected  保留所有public和protected成員       @preserve package    保留所有public, protected, package private成員       @preserve private    保留所有成員       @preserve all        相當於@preserve private

   事實上，即便不加@preserve指令，Jocky對Java語言特有的一些private層級的方法不進行混淆，譬如，在序列化時有特殊作用的writeObject及readObject方法等。但筆者強烈建議: 針對這些有特殊含義不能夠被混淆的 private層級的方法或者欄位，請以@preserve指令予以保護。
注1：建議通過IDE的JavaDoc設定，來輔助@preserve指令的書寫。

三、Jocky的限制

   正如前文所說，Jocky是基於原始碼的混淆編譯器，因此，Jocky不支援分別編譯，必須對所有的源檔案同時進行混淆編譯。但事實上，倘若混淆層級控制在private層級上，該限制便不複存在。