Adobe Air Registry Modifier

This project intended to provide an integration between Adobe Air projects and Windows Registry by which it is possible to modify Windows Registry in Adobe Air projects. Since Adobe Air is a cross-platform SDK, there is no built-in class to modify Windows Registry. However, it could be done using NativeProcess class and an interface tool between Adobe Air and Windows Registry such as Python.

Installation

Install Python 2.7.x
Download py2exe and install it.
In order to make a standalone process.exe file which is used as NativeProcess executer, open Command Prompt:

cd src-python
c:\PATH_TO_PYTHON\python.exe setup.py

Then, process.exe would be found in dist folder. Copy only process.exe file to your Adobe Air project (you don't need to include .py files in your Adobe Air project).

Note: In Adobe Air manifest file, use <supportedProfiles>extendedDesktop desktop</supportedProfiles> to be allowed to use NativeProcess.

How to use

Instantiate RegistryModify class:

import org.appsroid.RegistryModify;

RegistryModify rm = new RegistryModify("RELATIVE/PATH/TO/process.exe");
rm.addEventListener("ErrorData", onError);

// onError Listener
function onError(e:Event):void {
    trace("Error message:", rm._output);
}

// Read the value of a Key
rm.readValue("Root Key", "path\\to\\parent", "key_name");
rm.addEventListener("OutputData", onReadValue);

function onReadValue(e:Event):void {
    rm.removeEventListener("OutputData", onReadValue);
    trace("Value:", rm._output);
}

// Write a value to a Key
rm.writeValue("Root Key", "path\\to\\parent", "key_name", "value");
rm.addEventListener("OutputData", onWriteComplete);

function onWriteComplete(e:Event):void {
    rm.removeEventListener("OutputData", onWriteComplete);
    trace("Value was written.");
}

// Write a dword value to a Key
rm.writeDwordValue("Root Key", "path\\to\\parent", "key_name", "value");
rm.addEventListener("OutputData", onWriteDwordComplete);

function onWriteDwordComplete(e:Event):void {
    rm.removeEventListener("OutputData", onWriteDwordComplete);
    trace("Value was written.");
}

// Delete a Key
rm.deleteKey("Root Key", "path\\to\\key");
rm.addEventListener("OutputData", onDeleteComplete);

function onDeleteComplete(e:Event):void {
    rm.removeEventListener("OutputData", onDeleteComplete);
    trace("Key was deleted.");
}

// Check if a Key exists
rm.checkKey("Root Key", "path\\to\\key");
rm.addEventListener("OutputData", onCheckComplete);

function onCheckComplete(e:Event):void {
    rm.removeEventListener("OutputData", onCheckComplete);
    if (rm._output == "exists") {
        trace("We found the key!");
    } else {
        trace("Key not found.");
    }
}

Root Keys (as _rootkey parameter): HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER and HKEY_USERS
Example of _path parameter: Software\\Microsoft\\Office\\11.0\\Common\\General Don't use / rather than \\
Example of _key parameter: RecentFiles

silverfh / adobe-air-registry-modifier Goto Github PK