Home > action script > カスタムクラスとクラスパス

カスタムクラスとクラスパス

世の中には便利なクラスを作って下さる方がいます。
Robert Pennerさんのトゥイーン関連のクラスや、FlashでXPassを使えるxfactorstudioのXPass4AS2などは、汎用性ありまくりでマストな逸品です。
こういうカスタムクラス群を、しっかり管理しておく方法を、基本からまとめてみました。
書き終わったら冗長なエントリになってしまいました。Flashヘルプで検索した方が手っ取り早いです。orz..

ネットからダウンロードすると、クラスファイルが「com/作者のドメイン名/tween(任意)/~.asファイル」というディレクトリ構成になっていることがよくあります。asファイルをクラスファイル、そこまでのディレクトリ名をパッケージと呼びます。他の人が作ったパッケージと重複して上書きとかされるのを防ぐために、唯一の存在であるドメイン名で包むわけです。僕がtween関連のクラスを作ったら「com/trick7/tween/Twist.as」とかにするわけです。

以下、快適なカスタムクラス使用環境づくりのための作業手順です。

Windows :<ハードディスク>\Documents and Settings\<ユーザー>\customclasses Macintosh : <ハードディスク>/Users/<ユーザー>/customclasses というフォルダを作って、その中にcomフォルダごと移動します。

classpath1.jpg 複数個のパッケージを持っている場合、こんな感じになります。

このままここに置いているだけでは気軽に使えません。理想はダウンロードしたサンプルファイルのimport文のまま、

import com.xfactorstudio.xml.xpath.*;//XPathを使う時の例
のままで使いたいわけです。 そこでクラスパスの設定をします。

クラスパスには2種類あります。そのflaファイルの中だけで通用するドキュメントレベルのクラスパスと、全てのflaファイルで共有されるグローバルなクラスパスです。 Flashはimport指定を見つけると、まずドキュメントレベル、次にグローバルクラスパスの順にクラスを探し、それでも見つからない場合はエラーを返すそうです。(Flashヘルプに記載) ドキュメントレベルのクラスパスは、そのflaファイルのパブリッシュ設定から、グローバルなクラスパスはメニューの環境設定から、「ActionScript2.0設定」をクリックでそれぞれ設定します。

今回は末永く使いまくりたい汎用なクラスなので、グローバルなクラスパスとして設定します。「メニュー」→「環境設定」→「ActionScript」→「ActionScript2.0設定」で下のようなウィンドウが開きます。デフォルトでは「.(flaと同階層の意)」と「$(UserConfig)/Classes」の2つです。

※参考 $(UserConfig)/Classesっていうのは、 Windows :<ハードディスク>\Documents and Settings\<ユーザー>\Local Settings\Application Data\Macromedia\Flash 8\<言語>\Configuration\Classes
Macintosh : <ハードディスク>/Users/<ユーザー>/Library/Application Support/Macromedia/Flash 8/<言語>/Configuration/Classes を指すそうです。Flash 8フォルダにenとjaの2つのディレクトリがあって不思議だったのですが、jaだけを読み込んでいるんですね。知らなんだ。
なので、Configuration/Classesフォルダの中にcomパッケージを移してもいいのですが、Flash をアンインストールして再インストールした場合などに、ディレクトリが削除または上書きされてカスタムクラスが失われることがあるらしい&階層的に奥まった場所にあってややこしいので、<ユーザー>/customclassesを作ったわけです。職場との同期もしやすいですし。

classpath2.jpg で、開いた「ActionScript2.0設定」パネルの「+」をクリックして、さらに真ん中のボタンをクリックしてcustomclassesまでのパスを通せば完成です。 以降は設定したFlash環境上で、無造作に「import com.〜.*」でインポートできるようになります。以後、有益なクラスパッケージを見つけても customclasses フォルダに入れるだけでOKです。

9/6追記:en/jaフォルダについて文章、フォルダのパスに誤表記があったので訂正。 ついでに、納品するときは、使用したカスタムクラスのパッケージを、comフォルダがflaファイルと同階層になるようにしてコピーして(「.」のグローバルパスを利用するのです)、納品しましょう。

Comment:0

Comment Form

コメントを表示する前にこのブログのオーナーの承認が必要になることがあります。

Remember personal info

Trackback:0

TrackBack URL for this entry
http://www.trick7.com/blog/mt-tb.cgi/293
Listed below are links to weblogs that reference
カスタムクラスとクラスパス from trick7.com blog

Home > action script > カスタムクラスとクラスパス

持っている Flash & ActionScript 関連本の中から、自分的おすすめの読む順番をご紹介。各書籍のレビューは books カテゴリからご覧頂けます。
この順番でどう?(AS3.0)
  • Adobe Flash CS3 詳細! ActionScript 3.0 入門ノート (DVD付)
    Adobe Flash CS3 詳細! ActionScript 3.0 入門ノート (DVD付)

    デザイン方面からFlashデビューして、そのままAS2.0を使うようになった人が、難しいと評判のAS3デビューする時の最初の1冊として、とにかく目を通しておくと良いかと思います。プログラミング経験の少ない方でも、サンプルをじっくり読めば、ゼロからのAS3デビュー可。
  • ActionScript 3.0 アニメーション
    ActionScript 3.0 アニメーション
    洋書「Making Things Move!」の日本語訳本。ActionScript3.0で数学的アニメーションを作ることがメインテーマなのですが、前半部分でAS3.0の基礎を分かり易く解説されています。後半の重力, IK, 3D表現等のアニメーション解説も楽しい。僕はこれのAS2.0洋書版を読んでFlashの面白さに気付きました。
  • Adobe Flash CS3 詳細! ActionScript3.0入門ノート2 (CD-ROM付)
    Adobe Flash CS3 詳細! ActionScript3.0入門ノート2 (CD-ROM付)
    この次の辞典のような洋書を読む前の事前知識としてこの本の内容を理解しておくといいかも。
  • Essential ActionScript 3.0 (Essential)
    Essential ActionScript 3.0 (Essential)

    900ページ以上ある相当分厚い本。基礎からOOPまでを解説。ほぼ網羅しているので、これを抑えておけばAS3博士になれそう。
  • Actionscript 3.0 Cookbook
    Actionscript 3.0 Cookbook

    ActionScript3.0のリファレンス本。問題とその解決法が1ページぐらいで細分化されているので空いた時間にちょっとずつ読み進められる。WebでAS3のソースを見て勉強する時の字引としても使う。ただ、時期的に初期の本なので、AS3自体が仕様変更してたりするので正誤表は必読。
  • Object-Oriented Actionscript 3.0
    Object-Oriented Actionscript 3.0

    7/23に発売されたFlash&OOP本。AS2.0版は持っているのだけど、オブジェクト指向の初歩的な解説から入って、後半は僕の理解を超える難度になっていきました。今度こそ理解できるか?
この順番でどう?(AS2.0)
  • Foundation Actionscript Animation: Making Things Move (Foundation)
    Foundation Actionscript Animation: Making Things Move (Foundation)

    スクリプトでアニメーションさせる方法を学べる。プログラムの知識というよりも数学や物理の知識が必要。バネの表現や3D表現など、汎用性の高いテクニックを身に付けられ、個人の表現力をレベルアップするのに最適。参考までに、僕が調べた英単語リスト。2007年4月に、AS3対応版も発売されました。
  • ゲーム開発のための数学・物理学入門 Beginning Math and Physics for Game Programmers
    ゲーム開発のための数学・物理学入門  Beginning Math and Physics for Game Programmers

    「Making Things Move!」の世界を突き詰めたい人用のステップアップのための本。行列や物理運動、2D/3D表現。Flashの本ではなく、じっくり読むタイプの本なので、あとまわしにしてもいいかも。
  • Flash 8 Essentials
    Flash 8 Essentials

    Flash8の新機能を紹介。全10章が独立した構成で、興味のある部分から読めます。フィルタやビットマップ、ビデオの使い方とかを、基礎から順を追って理解していけるので、ゼロからスクリプティングできるようになる。僕はビットマップ関連の作業の際のリファレンスとして常用しています。
  • .fla―Idea of Flash Creation
    .fla―Idea of Flash Creation

    上の本でFlash8の基本を身に付けて、それをどう面白い表現に落とし込むかを学べます。深津さんの、試行錯誤・実験しやすいスクリプティング、クラス設計に凄さを感じました。YouTubeやFlickrのAPI、PHPとの連携記事も。
  • FLASH ActionScript 2.0入門完全ガイド+実践サンプル集 [CD-ROM付]
    FLASH ActionScript 2.0入門完全ガイド+実践サンプル集 [CD-ROM付]

    ここまでで表現力が付き、テンションが上がるので、その勢いで難解なオブジェクト指向に挑戦。プログラム経験のない人がいきなり英語のOOP本を読むのは厳しい。この本で継承とかインターフェースとかポリモーフィズムとかの用語を理解しておくといいかも。
  • オブジェクト指向でなぜつくるのか―知っておきたいプログラミング、UML、設計の基礎知識―
    オブジェクト指向でなぜつくるのか―知っておきたいプログラミング、UML、設計の基礎知識―

    Flashの本ではありませんが、OOPの概念を気軽に読めるボリュームで解説してくれます。英語と日本語のOOP用語の対応を図るためにも「Object-oriented Actionscript for Flash 8」と併読するのがおすすめ。なんとなく読んでおくだけでも結構違うのでは。
  • Object-oriented Actionscript for Flash 8
    Object-oriented Actionscript for Flash 8

    前半はOOPの利便性や基本の紹介。デザインパターンやMVCの理解。13章からグッと難しくなって大変。Flash8対応。
  • Essential Actionscript 2.0
    Essential Actionscript 2.0

    上の本よりもさらにOOPプログラマ向け。同じOOP本ということでやや重複しており、こちらはMX2004時代の本なので見送ってもいいかも。分かりやすい英語で良著。この本のAS3版が出たら間違いなく買い。

Page Top