Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Konfigurasi Global

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration


Kelas yang mencakup informasi konfigurasi global untuk satu instance Federasi Dagang (mencakup sejumlah pemanggilan konfigurasi aktual).

Ringkasan

Metode publik

abstract void cleanup ()

Pembersihan yang tepat saat tradefed shutdown.

abstract File cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs)

Filter GlobalConfiguration berdasarkan daftar putih dan keluaran ke file XML.

abstract File cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)

Filter GlobalConfiguration berdasarkan daftar putih sambil mengizinkan manipulasi nilai opsi dan keluaran ke file XML.

abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filter GlobalConfiguration berdasarkan daftar yang diizinkan dan keluaran ke file XML.

abstract ICommandScheduler getCommandScheduler ()

Mendapatkan ICommandScheduler untuk digunakan dari konfigurasi.

abstract Object getConfigurationObject (String typeName)

Mendapat objek konfigurasi khusus dengan nama yang diberikan.

abstract ICredentialFactory getCredentialFactory ()

Mendapatkan ICredentialFactory untuk membuat kredensial.

abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Mengembalikan DeviceManagementGrpcServer atau null jika tidak ditentukan.

abstract IDeviceManager getDeviceManager ()

Mendapatkan IDeviceManager untuk digunakan dari konfigurasi.

abstract getDeviceMonitors ()

Mendapatkan daftar IDeviceMonitor dari konfigurasi global.

abstract IDeviceSelection getDeviceRequirements ()

Mendapatkan IDeviceSelection untuk digunakan dari konfigurasi.

abstract TradefedFeatureServer getFeatureServer ()

Mengembalikan TradefedFeatureServer atau null jika tidak ditentukan.

abstract IConfigurationServer getGlobalConfigServer ()

Mendapat server konfigurasi global.

abstract getHostMonitors ()

Mendapat daftar IHostMonitor dari konfigurasi global.

abstract IHostOptions getHostOptions ()

Mendapat IHostOptions untuk digunakan dari konfigurasi.

abstract IHostResourceManager getHostResourceManager ()

Mendapatkan IHostResourceManager dari konfigurasi global.

abstract IKeyStoreFactory getKeyStoreFactory ()

Mendapatkan IKeyStoreFactory untuk digunakan dari konfigurasi.

abstract getMultiDeviceRecoveryHandlers ()

Mendapatkan daftar IMultiDeviceRecovery untuk digunakan dari konfigurasi.

abstract getOptionValues (String optionName)

Dapatkan daftar nilai opsi.

abstract getResourceMetricCollectors ()

Mendapatkan daftar IResourceMetricCollector dari konfigurasi global.

abstract ISandboxFactory getSandboxFactory ()

Dapatkan pabrik kotak pasir yang dapat digunakan untuk menjalankan pemanggilan

abstract IShardHelper getShardingStrategy ()

Mengembalikan IShardHelper yang menentukan cara untuk melakukan shard konfigurasi.

abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Mengembalikan TestInvocationManagementServer atau null jika tidak ditentukan.

abstract ITerribleFailureHandler getWtfHandler ()

Mendapatkan ITerribleFailureHandler untuk digunakan dari konfigurasi.

abstract void injectOptionValue (String optionName, String optionValue)

Menyuntikkan nilai opsi ke dalam kumpulan objek konfigurasi.

abstract void injectOptionValue (String optionName, String optionKey, String optionValue)

Menyuntikkan nilai opsi ke dalam kumpulan objek konfigurasi.

abstract void setCommandScheduler ( ICommandScheduler scheduler)

Setel ICommandScheduler , ganti nilai yang ada.

abstract void setConfigurationFactory ( IConfigurationFactory configFactory)

Atur IConfigurationFactory untuk konfigurasi ini.

abstract void setConfigurationObject (String name, Object configObject)

Metode generik untuk menyetel objek konfigurasi dengan nama yang diberikan, menggantikan nilai apa pun yang ada.

abstract void setConfigurationObjectList (String typeName, configList) setConfigurationObjectList (String typeName, configList)

Metode umum untuk menyetel daftar objek konfigurasi untuk nama yang diberikan, menggantikan nilai apa pun yang ada.

abstract void setDeviceManagementServer ( DeviceManagementGrpcServer server)

Menyetel DeviceManagementGrpcServer .

abstract void setDeviceManager ( IDeviceManager deviceManager)

Setel IDeviceManager , ganti nilai yang ada.

abstract void setDeviceMonitor ( IDeviceMonitor deviceMonitor)

Setel IDeviceMonitor .

abstract void setDeviceRequirements ( IDeviceSelection deviceSelection)

Setel IDeviceSelection , ganti nilai yang ada.

abstract void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Tetapkan daftar IHostMonitor .

abstract void setHostOptions ( IHostOptions hostOptions)

Setel IHostOptions , ganti nilai yang ada.

abstract void setHostResourceManager ( IHostResourceManager hostResourceManager)

Setel IHostResourceManager , menggantikan nilai yang ada.

abstract void setInvocationServer ( TestInvocationManagementServer server)

Menyetel TestInvocationManagementServer .

abstract void setKeyStoreFactory ( IKeyStoreFactory factory)

Setel IKeyStoreFactory , ganti nilai yang ada.

abstract setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs)

Tetapkan bidang Option konfigurasi global dengan serangkaian argumen baris perintah yang diberikan

Lihat ArgsOptionParser untuk format yang diharapkan

abstract void setOriginalConfig (String config)

Menetapkan konfigurasi asli yang digunakan untuk membuat konfigurasi global.

abstract void setResourceMetricCollector ( IResourceMetricCollector collector)

Menyetel IResourceMetricCollector .

abstract void setSandboxFactory ( ISandboxFactory factory)

Setel ISandboxFactory , ganti nilai yang ada.

abstract void setShardingStrategy ( IShardHelper sharding)

Menyetel IShardHelper untuk digunakan saat melakukan sharding pada konfigurasi.

abstract void setTradefedFeatureServer ( TradefedFeatureServer server)

Mengatur TradefedFeatureServer .

abstract void setWtfHandler ( ITerribleFailureHandler wtfHandler)

Tetapkan ITerribleFailureHandler .

abstract void setup ()

Pengaturan yang tepat di awal tradefed.

abstract void validateOptions ()

Validasi nilai opsi.

Metode publik

membersihkan

public abstract void cleanup ()

Pembersihan yang tepat saat tradefed shutdown.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

Filter GlobalConfiguration berdasarkan daftar putih dan keluaran ke file XML.

Parameter
exclusionPatterns : Pola nama kelas yang akan dikecualikan dari dump.

allowlistConfigs String : larik konfigurasi ERROR(/String) untuk disertakan dalam file XML baru. Jika disetel ke null , a default list should be used.

Pengembalian
File File yang berisi konfigurasi global baru yang difilter.

Melempar
IOException

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

Filter GlobalConfiguration berdasarkan daftar putih sambil mengizinkan manipulasi nilai opsi dan keluaran ke file XML.

Parameter
exclusionPatterns : Pola nama kelas yang akan dikecualikan dari dump.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String : larik konfigurasi ERROR(/String) untuk disertakan dalam file XML baru. Jika disetel ke null , a default list should be used.

Pengembalian
File File yang berisi konfigurasi global baru yang difilter.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filter GlobalConfiguration berdasarkan daftar yang diizinkan dan keluaran ke file XML.

Misalnya, untuk konfigurasi berikut: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

semua konfigurasi kecuali "key_store" akan disaring, dan menghasilkan file konfigurasi dengan konten berikut: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Parameter
allowlistConfigs String : larik konfigurasi ERROR(/String) untuk disertakan dalam file XML baru. Jika disetel ke null , a default list should be used.

Pengembalian
File File yang berisi konfigurasi global baru yang difilter.

Melempar
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Mendapatkan ICommandScheduler untuk digunakan dari konfigurasi.

Pengembalian
ICommandScheduler yang ICommandScheduler . Tidak akan pernah mengembalikan nol.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

Mendapat objek konfigurasi khusus dengan nama yang diberikan.

Parameter
typeName String : tipe unik dari objek konfigurasi

Pengembalian
Object objek atau null jika objek dengan nama tersebut tidak ditemukan

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Mendapatkan ICredentialFactory untuk membuat kredensial.

Pengembalian
ICredentialFactory ICredentialFactory atau null jika tidak ada yang ditentukan.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Mengembalikan DeviceManagementGrpcServer atau null jika tidak ditentukan.

Pengembalian
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Mendapatkan IDeviceManager untuk digunakan dari konfigurasi. Mengelola kumpulan perangkat yang tersedia untuk pengujian

Pengembalian
IDeviceManager IDeviceManager disediakan dalam konfigurasi.

getDeviceMonitors

public abstract  getDeviceMonitors ()

Mendapatkan daftar IDeviceMonitor dari konfigurasi global.

Pengembalian
daftar IDeviceMonitor dari konfigurasi global, atau null jika tidak ditentukan.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

Mendapatkan IDeviceSelection untuk digunakan dari konfigurasi. Mewakili filter global di perangkat mana yang dapat dilihat DeviceManager .

Pengembalian
IDeviceSelection IDeviceSelection disediakan dalam konfigurasi.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Mengembalikan TradefedFeatureServer atau null jika tidak ditentukan.

Pengembalian
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Mendapat server konfigurasi global. Server konfigurasi global digunakan untuk mendapatkan konfigurasi host dari server alih-alih mendapatkannya dari file lokal.

Pengembalian
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Mendapat daftar IHostMonitor dari konfigurasi global.

Pengembalian
daftar IHostMonitor dari konfigurasi global, atau null jika tidak ditentukan.

getHostOptions

public abstract IHostOptions getHostOptions ()

Mendapat IHostOptions untuk digunakan dari konfigurasi.

Pengembalian
IHostOptions IDeviceManager disediakan dalam konfigurasi.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Mendapatkan IHostResourceManager dari konfigurasi global.

Pengembalian
IHostResourceManager IHostResourceManager dari konfigurasi global, atau implementasi default LocalHostResourceManager jika tidak ada yang ditentukan dalam konfigurasi host.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Mendapatkan IKeyStoreFactory untuk digunakan dari konfigurasi.

Pengembalian
IKeyStoreFactory IKeyStoreFactory atau null jika tidak ada pabrik penyimpanan kunci yang disetel.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

Mendapatkan daftar IMultiDeviceRecovery untuk digunakan dari konfigurasi.

Pengembalian
daftar IMultiDeviceRecovery , atau null jika tidak disetel.

getOptionValues

public abstract  getOptionValues (String optionName)

Dapatkan daftar nilai opsi.

Parameter
optionName String : nama opsi peta

Pengembalian
daftar nilai opsi yang diberikan. null jika nama opsi tidak ada.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Mendapatkan daftar IResourceMetricCollector dari konfigurasi global.

Pengembalian
daftar IResourceMetricCollector dari konfigurasi global atau null jika tidak ada yang ditentukan.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Dapatkan pabrik kotak pasir yang dapat digunakan untuk menjalankan pemanggilan

Pengembalian
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Mengembalikan IShardHelper yang menentukan cara untuk melakukan shard konfigurasi.

Pengembalian
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Mengembalikan TestInvocationManagementServer atau null jika tidak ditentukan.

Pengembalian
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Mendapatkan ITerribleFailureHandler untuk digunakan dari konfigurasi. Menangani apa yang harus dilakukan jika terjadi WTF (What a Terrible Failure).

Pengembalian
ITerribleFailureHandler ITerribleFailureHandler disediakan dalam konfigurasi, atau null jika tidak ada penangan yang disetel

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Menyuntikkan nilai opsi ke dalam kumpulan objek konfigurasi.

Berguna untuk memberikan nilai untuk opsi yang dihasilkan secara dinamis.

Parameter
optionName String : nama opsi

optionValue String : nilai opsi

Melempar
ConfigurationException jika gagal menetapkan nilai opsi

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

Menyuntikkan nilai opsi ke dalam kumpulan objek konfigurasi.

Berguna untuk memberikan nilai untuk opsi yang dihasilkan secara dinamis.

Parameter
optionName String : nama opsi peta

optionKey String : kunci opsi peta

optionValue String : nilai opsi peta

Melempar
ConfigurationException jika gagal menetapkan nilai opsi

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Setel ICommandScheduler , ganti nilai yang ada.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Atur IConfigurationFactory untuk konfigurasi ini.

Parameter
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

Metode generik untuk menyetel objek konfigurasi dengan nama yang diberikan, menggantikan nilai apa pun yang ada.

Parameter
name String : nama unik dari tipe objek konfigurasi.

configObject Object : objek konfigurasi

Melempar
ConfigurationException jika configObject bukan tipe yang benar

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

Metode umum untuk menyetel daftar objek konfigurasi untuk nama yang diberikan, menggantikan nilai apa pun yang ada.

Parameter
typeName String : nama unik dari tipe objek konfigurasi.

configList : daftar objek konfigurasi

Melempar
ConfigurationException jika ada objek dalam daftar yang bukan tipe yang benar

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Menyetel DeviceManagementGrpcServer .

Parameter
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

Setel IDeviceManager , ganti nilai yang ada. Ini menetapkan pengelola untuk perangkat uji

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Setel IDeviceMonitor .

Parameter
deviceMonitor IDeviceMonitor : Monitor

Melempar
ConfigurationException jika IDeviceMonitor telah disetel.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Setel IDeviceSelection , ganti nilai yang ada. Ini menyetel filter perangkat global di perangkat mana yang dapat dilihat DeviceManager .

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Tetapkan daftar IHostMonitor .

Parameter
hostMonitors : Daftar monitor

Melempar
ConfigurationException jika IHostMonitor telah disetel.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Setel IHostOptions , ganti nilai yang ada.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Setel IHostResourceManager , menggantikan nilai yang ada.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Menyetel TestInvocationManagementServer .

Parameter
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Setel IKeyStoreFactory , ganti nilai yang ada.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

Tetapkan bidang Option konfigurasi global dengan serangkaian argumen baris perintah yang diberikan

Lihat ArgsOptionParser untuk format yang diharapkan

Parameter
listArgs : argumen baris perintah

Pengembalian
argumen yang tidak termakan

Melempar
ConfigurationException

setOriginalConfig

public abstract void setOriginalConfig (String config)

Menetapkan konfigurasi asli yang digunakan untuk membuat konfigurasi global.

Parameter
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

Menyetel IResourceMetricCollector .

Parameter
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

Setel ISandboxFactory , ganti nilai yang ada.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

Menyetel IShardHelper untuk digunakan saat melakukan sharding pada konfigurasi.

Parameter
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Mengatur TradefedFeatureServer .

Parameter
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Tetapkan ITerribleFailureHandler .

Parameter
wtfHandler ITerribleFailureHandler : penangan WTF

Melempar
ConfigurationException jika ITerribleFailureHandler telah ditetapkan.

mempersiapkan

public abstract void setup ()

Pengaturan yang tepat di awal tradefed.

Melempar
com.android.tradefed.config.ConfigurationException
ConfigurationException

validasiOptions

public abstract void validateOptions ()

Validasi nilai opsi.

Saat ini hanya akan memvalidasi bahwa semua opsi wajib telah ditetapkan

Melempar
ConfigurationException jika konfigurasi tidak memiliki kolom wajib