API及特權檢查器

IDE提供了API和特權檢查器工具來檢查應用程序的代碼可能存在的有關API和privilege特權使用的相關問題??.

注意

API和特權檢查器僅對C++和FLASH應用有效

這個檢查在項目打包過程將自動完成. 若需要在?build process項目構建過程也自動檢查, 你需要在project properties項目屬性中打開

構建檢測.你也可以在IDE中手動執行改建查,選擇?Project > Check API and Privilege Violations.

檢查的結果將顯示在?Problems?視圖中. 下圖顯示了一些檢查可能產生的提示

Table: API usage check alarms

?

警告類型 描述 消息格式 解決方法 API version violation 應用包含較本應用使用的API版本更新的API中的類,方法,枚舉,常量 {Fully-qualified API name} – API Version {version identifier}

For example:?Osp::Media::Image::DecodeN – API Version 1.1

可以更新應用的API版本,并重新下載manifest file?, 或者不使用報告有錯的類,方法等. Internal API usage( 應用使用了一個內部 class, method, enumerator, 或者 constant. {Fully-qualified API name} – Cannot be used

For example:?Osp::Media::Image::DecodeN – Cannot be used

不使用報告有錯的類,方法等. API compatibility alarm 應用使用了有版本兼容性問題的 class, method, enumerator, or constant? {Fully-qualified API name} – May be incompatible

For example:?Osp::Media::Image::DecodeN - May be incompatible

查看?C++ API Reference?關于版本兼容性問題的詳細描述,并確保應用運行正常 API deprecation alarm 應用使用了過期的class, method, enumerator, or constant? {Fully-qualified API name} - Deprecated

For example:?Osp::Media::Image::DecodeN - Deprecated

查看引起過期的原因,并考慮使用平臺建議的替代API(如果提供有)替換過期的API.大多數情況下,替代API都會提供. 但是如果沒有替代API,你仍然可以在當前SDK下使用這個過期API, 并不會有任何異常.但是要注意的是過期的API可能今后會在沒有任何通知的情況下從平臺中被移除.

請注意,當一個class 或者 method 被寧外一個class 或者 method重載后, 檢查器可能會生成一個錯誤的報告. 那么如何來判斷警告信息

是否有效呢? 我們可以檢查這個類/方法是否有不同的特征,例如兼容性,有效性,或者其它內部問題. 如果沒有上述特征,那么這個警告很

有可能是無用的

Table: Privilege 檢查警告 警告類型 描述 消息格式 解決方法 Privilege violation 應用使用了未在manifest中聲明的特權組中的方法 The {Privilege-group name} privilege is required for {Fully-qualified API name}.

For example:?The IMAGE privilege is required for Osp::Media::Image::DecodeN.

可以在bada開發網上分配特權組并重新下載manifest文件.或者停止使用報告的方法.特權違規操作是應用在資質審查階段被拒的重要理由之一. Unused privilege 應用未使用任何屬于通報的特權組的方法 The {Privilege-group name} privilege remains unused.

For example:?The WEB_SERVICE privilege remains unused.

在bada開發網中移除改特權組,并重新下載manifest文件,如果你在之后會用到改特權組的方法,那么此時你可以忽略改警告信息

?

注意 bada SDK 2.0.0不支持Simulator模擬器(指Simulator,而非Emulator模擬器,兩者區別可以參看前面譯文中的解釋).如果你的應用使用了
Simulator-Debug?設置,API及特權檢查器可能會工作不正常.因此,在開發應用時如果使用的是早于2.0版本SDK開發的應用項目,你需要
把你的應用整合到bada SDK2.0.0版本下(migrate your application).?