Cross-Development Programming Guide: 廃止されたAPIの検索

Mac OS Xが進化するにつれて、網羅されるAPIとテクノロジーはデベロッパの要求に応じるために変更されることがあります。この進化の中で、従来のインターフェイスが廃止され、新しい、より効率的なインターフェイスに取って代わられることがあります。アップルでは、このような変更は、不可欠と見なされた場合に限り行い、廃止されたインターフェイスは利用可否判定マクロ（/usr/include/AvailabilityMacros.hで定義されています）を使って見つけることができるようにしています。

注：廃止は、フレームワークやライブラリからのインターフェイスの削除を意味するものではありません。単に、より優れたものが存在しているインターフェイスを表す手段です。たとえば、新しい、より効率的なインターフェイスの使用を優先して、古いインターフェイスの使用が推奨されなくなります。廃止されたインターフェイスも依然としてコードの中で使用することは可能ですが、アップルでは、可能な限り早期に新しいインターフェイスに移行することを推奨します。廃止されたインターフェイスのヘッダファイルやドキュメントで、推奨される代替のインターフェイスについての情報がないかどうか確認してください。

廃止されたインターフェイスにはそれぞれ、廃止されたものとしてマークされたときのMac OS Xのバージョンを識別するマクロが標識として付きます。たとえば、Mac OS Xバージョン10.0で導入され、バージョン10.3で廃止されたインターフェイスには、そのヘッダファイルの宣言の後に、次のマクロがあります。

AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER_BUT_DEPRECATED_IN_MAC_OS_X_VERSION_10_3

Mac OS Xバージョン10.3で実行するようにプロジェクトをコンパイルして、このマクロが標識としてついているインターフェイスを使用していた場合、そのインターフェイスが現在は廃止されていることを示す警告が表示されます。このマクロは、次の属性をインターフェイス宣言に追加することによってこの処理を達成します。

コードがこの属性が標識として付いている関数を参照すると、コンパイラは警告を発します。この警告には、廃止されたインターフェイスの名前と、コード中でそれが参照された場所が含まれています。たとえば、HPurge関数が廃止されていた場合は、次のようなエラーが発生します。

廃止されたインターフェイスへの参照を見つけるには、この種の警告を探します。プロジェクトに多数の警告がある場合は、Xcodeの検索フィールドを使って、“deprecated”キーワードに基づくフィルタをリストに適用することができます。




	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. \| Terms of use \| Privacy Notice