A collection of cross-platform Java APIs for various native APIs. Supports OS X, Linux, Solaris and Windows.

These APIs support Java 5 and later. Some of these APIs overlap with APIs available in later Java versions.

• Get PID of current process.
• Get kernel name and version.
• Get machine architecture.

These bindings work for both the UNIX terminal and the Windows console:

• Determine if stdout/stderr are attached to a terminal.
• Query the terminal size.
• Switch between bold and normal mode on the terminal.
• Change foreground color on the terminal.
• Move terminal cursor up, down, left, right, start of line.
• Clear to end of line.

• Get and set UNIX file mode.
• Create and read symbolic links.
• List the available file systems on the machine
• Query file system mount point.
• Query file system type.
• Query file system device name.
• Query whether a file system is local or remote.

Currently ported to OS X, Linux and Windows, with some support for Solaris and FreeBSD. Tested on:

• OS X 10.7.4, 10.8 (x86_64), 10.6.7 (i386)
• Ubunutu 12.04 (amd64), 8.04.4 (i386, amd64)
• Solaris 11 (x86)
• Windows 7 (x64), XP (x86)

Include native-platform.jar and native-platform-${os}-${arch}.jar in your classpath. From Gradle, you can do this:

repositories {
    maven { url "https://gradle.artifactoryonline.com/gradle/libs-releases-local" }
}

dependencies {
    compile "net.rubygrapefruit:native-platform:0.1"
}

Some sample code to use the terminal:

import net.rubygrapefruit.platform.Native;
import net.rubygrapefruit.platform.Terminals;
import net.rubygrapefruit.platform.Terminal;
import static net.rubygrapefruit.platform.Terminals.Output.*;

Terminals terminals = Native.get(Terminals.class);

// check if terminal
terminals.isTerminal(Stdout);

// use terminal
Terminal stdout = terminals.getTerminal(Stdout);
stdout.bold();
System.out.println("bold text");

Initial release

You will need to use the Gradle wrapper. Just run gradlew in the root directory.

The g++ compiler is required to build the native library. You will need the g++ package for this. Usually this is already installed.

You need to install the libncurses5-dev package to pick up the ncurses header files. Also worth installing the ncurses-doc package too.

Where multi-arch support is available (e.g. recent Ubuntu releases), you can build the i386 and amd64 versions of the library on the same machine.

You need to install the gcc-multilib and g++-multilib packages to pick up i386 support.

You need to install the lib32ncurses5-dev package to pick up the ncurses i386 version.

To build, include -Pmultiarch on the command-line.

You need to install Visual studio, and build from a Visual studio command prompt.

The g++ compiler is required to build the native library. You will need to install the XCode tools for this.

For Solaris 11, you need to install the development/gcc-45 and system/header packages.

Run gradle installApp to install the test application into test-app/build/install/native-platform-test. Or gradle distZip to create an application distribtion in test-app/build/distributions/native-platform-test-$version.zip.

You can run $INSTALL_DIR/bin/native-platform-test to run the test application.

1. Create a tag and push.
2. Build each variant:
   1. Checkout tag.
   2. ./gradlew clean test :uploadJni -Prelease -PartifactoryUserName=<> -PartifactoryPassword=<>
   • OS X universal
   • Linux i386, using Ubunutu 8.04
   • Linux amd64, using Ubunutu 8.04
   • Windows x86, using VC++ 2010
   • Windows x64
3. Build Java library and test app:
   1. Checkout tag.
   2. ./gradlew clean test :uploadArchives testApp:uploadArchives -Prelease
4. Checkout master
5. Increment version number.

• Test on IBM JVM.
• Test on Java 5, 6, 7.
• Test on Windows 7, Windows XP

• Windows: fix detection of shared drive under VMWare fusion and Windows XP
• Linux: detect remote filesystems.
• Solaris: fix unicode file name handling.
• Solaris: fail for unsupported architecture.
• Solaris: build 32 bit and 64 bit libraries.
• Freebsd: finish port.
• Freebsd: fail for unsupported architecture.
• Freebsd: build 32 bit and 64 bit libraries.

• Use wchar_to_java() for windows system and file system info.
• Test network file systems on Mac, Linux, Windows
• Test mount points on Windows
• Cache class, method and field lookups (in particular for String conversions).
• Determine C charset once at startup
• Change readLink() implementation so that it does not need to NULL terminate the encoded content
• Don't use NewStringUTF() anywhere
• Don't use NewString() anywhere
• Use iconv() to convert from C char string to UTF-16 when converting from C char string to Java String.
• Support for cygwin terminal
• Use TERM=xtermc instead of TERM=xterm on Solaris.
• Add diagnostics for terminal.
• Split out separate native library for terminal handling.
• Version each native interface separately.
• String names for errno values.
• Split into multiple projects.
• Convert to c.
• Make native library extraction multi-process safe.
• Use fully decomposed form for unicode file names on hfs+ filesystems.
• Extend FileSystem to deal with removable media.

• Expose platform-specific HTTP proxy configuration. Query registry on windows to determine IE settings.