メインコンテンツまでスキップ

独自のアドオンを作成する

Proxyman Scripting で使う独自の JavaScript アドオンを作成し、カスタムアドオンフォルダに保存して、require() であらゆるスクリプトにインポートする方法を解説します。

1. 概要​

組み込みアドオンではまだできないことを行うために、独自のアドオンを作成できます。次のことが可能です:

  • 独自の JavaScript アドオンを作成する
  • 組み込みライブラリを使う
  • 独自のライブラリを作成して、同僚と共有する

2. アドオンの作り方​

  1. ユーザーアドオンフォルダ ~/Library/Application\ Support/com.proxyman.NSProxy/users を開きます。または、Script Editor で More → Documentations → Open Custom Addons Folder... をクリックします。
Documentations を開いた Proxyman Script Editor の More メニューで、Open Custom Addons Folder がハイライトされている画面

カスタムアドオンフォルダを開く

2. HelloWorld.js ファイルを複製し、名前を MyAwesomeAddon.js に変更します。

3. ファイルを開き、テンプレートを確認します。

4. メタデータを変更して、JS コードを書きます

/**
{
"name":"My Awesome Addon",
"description":"The first User Addons",
"author":"Proxyman",
"tags":"helloworld"
}
**/

const { md5 } = require("@addons/MD5.js");

const sayHello = () => {
var content = "Hello World. My first custom Addon.";
var hash = md5(content);
return content + ". MD5 = " + hash;
};

// Make sure you export the function at the end of method
exports.sayHello = sayHello;

  • 組み込みアドオンは require("@addons/<name.js>") でインポートできます
const { md5 } = require("@addons/MD5.js");
備考

Proxyman が提供する組み込みアドオンをご覧ください

  • 組み込みライブラリは require("@libs/<name.js>") でインポートできます
備考

Proxyman が提供する組み込みライブラリをご覧ください

5. ファイルを保存します

6. Proxyman でスクリプトを開き、アドオンをインポートします

// Import your addon
// Make sure you import the functions that you export in the addon
const { sayHello } = require("@users/MyAwesomeAddon.js");

// Usage
sayHello();
備考

require("@users/MyAwesomeAddon.js") の @users は、カスタムアドオンフォルダを指します。

3. 注意事項​

備考

独自のアドオンは ~/Library/Application\ Support/com.proxyman.NSProxy/users に保存されます

このフォルダは安全です。Proxyman によって上書きされたり、削除されたりすることはありません。