Ant 移行ツールの使用

Force.com IDE に加えて、Apex のリリースにスクリプトを使用することもできます。

Apache の Ant 開発ツールを使用して、Developer Edition または Sandbox を使用している組織から本番組織にメタデータの変更および Apex クラスをファイルベースでリリースする場合は、Ant 移行ツールをダウンロードします。

Ant 移行ツールは Salesforce により提供される、ユーザとパートナーをサポートする無料のリソースですが、Salesforce のマスターサブスクリプション契約 (MSA) におけるサービスの一部とはみなされません。

メモ

Ant 移行ツールを使うには、次を行います。

http://www.oracle.com/technetwork/java/javase/downloads/index.html にアクセスし、Java JDK をインストールします。
セキュリティを強化するために、Java 7 以降および Ant 移行ツールの最新バージョン (バージョン 36.0 以降) をお勧めします。バージョン 36.0 以降の Ant 移行ツールは、Java バージョン 7 (1.7) を検出したときに Salesforce との安全な通信に TLS 1.2 を使用します。Java 7 の場合、TLS 1.1 および 1.2 が明示的に有効になります。Java 8 (1.8) の場合、TLS 1.2 が使用されます。Java バージョン 6 の場合は、TLS 1.0 が使用されますが、現在 Salesforce ではサポートされていません。
または、Java 7 を使用している場合、Ant 移行ツールをバージョン 36.0 以降にアップグレードする代わりに、ANT_OPTS 環境変数に次の設定を追加できます。
この設定によって、ローカルシステムにある他の Ant ツールにも TLS 1.1 および 1.2 が適用されます。
メモ
http://ant.apache.org/ にアクセスし、Apache Ant のバージョン 1.6 以降をリリースマシンにインストールします。
環境変数 (ANT_HOME、JAVA_HOME、PATH など) を、http://ant.apache.org/manual/install.html の『Ant Installation Guide』で指定されたように設定します。
コマンドプロンプトを開き、ant –version を入力して、JDK と Ant が正しくインストールされているか確認してください。出力は次のようになります。
Summer '18 Ant 移行ツールの .zip ファイルをダウンロードします。(Winter '19 Ant 移行ツールのプレビューバージョンが含まれる .zip ファイルをダウンロードすることもできます)。このダウンロードリンクでは、Salesforce に対する認証は行われません。Salesforce にログインしている場合は、いったんログアウトしてからブラウザでこのリンクにアクセスすることをお勧めします。
ダウンロードしたファイルを、任意のディレクトリに展開します。Zip ファイルには次が含まれます。
- ツールの使用方法を説明した Readme.html ファイル
- Ant タスクを含む Jar ファイル: ant-salesforce.jar
- 次の内容を含むサンプルフォルダ:
  - SampleDeployClass.cls と SampleFailingTestClass.cls を含む codepkg\classes フォルダ
  - SampleAccountTrigger.trigger を含む codepkg\triggers フォルダ
  - 例で使用するカスタムオブジェクトを含む mypkg\objects フォルダ
  - 組織から例を削除するための XML ファイルを含む removecodepkg フォルダ
  - build.xml の Ant タスクを実行するための認証情報を指定するサンプル build.properties ファイル
  - deploy および retrieve API コールを実行するサンプル build.xml ファイル
Ant 移行ツールは、配布 ZIP ファイル内にある ant-salesforce.jar ファイルを使用します。以前のバージョンのツールをインストールして ant-salesforce.jar を Ant lib ディレクトリにコピーしている場合は、以前の jar ファイルを削除します。lib ディレクトリは、Ant のインストール先のルートフォルダにあります。この新しい jar ファイルを Ant lib ディレクトリにコピーする必要はありません。
展開したファイル内のサンプルサブディレクトリを開きます。
build.properties ファイルを編集します。
1. Salesforce 本番組織ユーザ名およびパスワードを、sf.user と sf.password 項目にそれぞれ入力します。
  - Apex を編集するための権限を持っているユーザ名を指定する必要があります。
  - 信頼されないネットワークから Ant 移行ツールを使用する場合、パスワードにセキュリティトークンを追加します。セキュリティトークンについての詳細は、Salesforce オンラインヘルプの「セキュリティトークンのリセット」を参照してください。
  メモ
2. Sandbox 組織にリリースする場合、sf.serverurl 項目を https://test.salesforce.com に変更してください。
サンプルディレクトリのコマンドウィンドウを開きます。
ant deployCode を入力します。これは、Ant 移行ツールで提供されたサンプルクラスと Account トリガを使用して、deploy API コールを実行します。
ant deployCode は、build.xml ファイルの deploy という名前の Ant ターゲットをコールします。

詳細は、「deploy について」を参照してください。
ant deployCode の実行の一部として追加されたテストクラスとトリガを削除するには、コマンドウィンドウ ant undeployCode 内で次を入力します。
ant undeployCode は、build.xml ファイル内で undeployCode という Ant ターゲットをコールします。

Ant 移行ツールについての詳細は、『Ant 移行ツールガイド』を参照してください。

Apex 開発者ガイド

Ant 移行ツール の使用

Ant 移行ツールの使用