JFlashPlayer - Usage Instructions

Requirements

JFlashPlayer supports Windows 98, Me, NT4, 2000, XP, and Vista
Non-windows operating systems are not supported
JFlashPlayer requires the inclusion of native DLL files with your java application. These files must be located in either the current working directory or on the system path of the machine.
A Flash Player must be installed for JFlashPlayer to work. JFlashPlayer can detect if a Flash Player is present. If one is not present, you can use the installFlash method.

Adding JFlashPlayer to your Project

To add the JFlashPlayer classes to your project, simply add the included jar file to your classpath. Some IDEs refer to this as libraries on the Java build path of your project. You can then build your project and include the JFlashPlayer classes with your application distributables. Also be sure to include the resource installflash.zip that is within jflashplayer.jar. This file is necessary for installFlash() to work.

Obfuscation

There are numerous free java obfuscators available. We recommend ProGuard. For JFlashPlayer to work, some classes and methods must not be obfuscated. Below is an example of a proguard obfuscation file you could use with JFlashPlayer.

-libraryjars <java.home>\lib\rt.jar
-injars      myapp_pre.jar
-outjar      myapp.jar

-dontwarn javax.swing.ZPopupMenu

# keep all native method names and the names of their classes
-keepclasseswithmembernames class * {
    native <methods>;
}

# keep class name FlashPanel
-keepnames class com.jpackages.jflashplayer.FlashPanel

# keep method notifyCallback
-keep class com.jpackages.jflashplayer.FlashPanel {
  private void notifyCallback(int, int, int, int, java.lang.String,
  java.lang.String);
}

# keep method processFlashCall
-keep class com.jpackages.jflashplayer.FlashPanel {
  private java.lang.String processFlashCall(java.lang.String);
}