新@SystemApi註釋的含義是什麼，與@hide有什麼不同？

Question

Android最近在其SDK源代碼中引入了@SystemApi。看起來和之前的@hide註解一樣有效，因爲它們也從SDK jar類中剝離。

應用程序是否有可能以不同於舊的@hide API的方式調用它們。

/** 
* Indicates an API is exposed for use by bundled system applications. 
* <p> 
* These APIs are not guaranteed to remain consistent release-to-release, 
* and are not for use by apps linking against the Android SDK. 
* </p><p> 
* This annotation should only appear on API that is already marked <pre>@hide</pre>. 
* </p> 
* 
* @hide 
*/ 

Answer 1

中的方法@SystemApi註釋是那些與@hide的子集。 這顯然是內部團隊（也可能是合作伙伴）的一個指標，即這些方法是實際的API，但不適用於公共開發者。

因此，@SystemApi方法比@hide方法更穩定，在未來任何時候都可以進行更改，而無需考慮任何兼容性，並且任何OEM都可以根據自己的意願更改它們。

如果您嘗試通過反射調用內部API，則始終首選@SystemApi方法以實現更好的未來兼容性。

Answer 2

@SystemApi，@PrivateApi和@hide

據this commit，@SystemApi是老@PrivateApi重命名。標記爲@hide的API不一定是@SystemApi，但@SystemApi需要@hide。

有關@hide javadoc註釋的更多信息，this post給出了一個很好的答案。

根據我自己的實驗，一個（非系統應用程序）仍然可以訪問@hide API和領域使用Java反射像（來自this post）：

WifiManager manager = (WifiManager) getSystemService(Context.WIFI_SERVICE); 

WifiConfiguration config = new WifiConfiguration(); 
config.SSID = "AccessPointSSID"; 

Method method = manager.getClass().getMethod("setWifiApEnabled", WifiConfiguration.class, boolean.class); 
method.invoke(manager, config, true); 

但試圖訪問@SystemApi事情使用Java反射是不可能的（以下代碼將觸發invocationTargetException）：

WifiManager manager = (WifiManager) getSystemService(Context.WIFI_SERVICE); 

Method method = manager.getClass().getMethod("getPrivilegedConfiguredNetworks"); 
List<WifiConfiguration> configs = (List<WifiConfiguration>)method.invoke(manager); 

P.S.

在WifiManager java code中，setWifiApEnabled和getPrivilegedConfiguredNetworks的API被定義爲：

/** 
* Start AccessPoint mode with the specified 
* configuration. If the radio is already running in 
* AP mode, update the new configuration 
* Note that starting in access point mode disables station 
* mode operation 
* @param wifiConfig SSID, security and channel details as 
*  part of WifiConfiguration 
* @return {@code true} if the operation succeeds, {@code false} otherwise 
* 
* @hide Dont open up yet 
*/ 
public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 
    try { 
     mService.setWifiApEnabled(wifiConfig, enabled); 
     return true; 
    } catch (RemoteException e) { 
     return false; 
    } 
} 

和

/** @hide */ 
@SystemApi 
public List<WifiConfiguration> getPrivilegedConfiguredNetworks() { 
    try { 
     return mService.getPrivilegedConfiguredNetworks(); 
    } catch (RemoteException e) { 
     return null; 
    } 
}