Cấu hình IGlobal

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration


Một lớp bao gồm thông tin cấu hình toàn cầu cho một phiên bản Liên đoàn Thương mại (bao gồm bất kỳ số lượng lệnh gọi cấu hình thực tế nào).

Bản tóm tắt

Phương pháp công khai

abstract void cleanup ()

Dọn dẹp đúng cách khi tắt máy.

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

Lọc GlobalConfiguration dựa trên danh sách trắng và xuất ra tệp XML.

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

Lọc GlobalConfiguration dựa trên danh sách trắng đồng thời cho phép thao tác các giá trị tùy chọn và xuất ra tệp XML.

abstract File cloneConfigWithFilter (String... allowlistConfigs)

Lọc GlobalConfiguration dựa trên danh sách được phép và xuất ra tệp XML.

abstract ICommandScheduler getCommandScheduler ()

Lấy ICommandScheduler để sử dụng từ cấu hình.

abstract Object getConfigurationObject (String typeName)

Lấy đối tượng cấu hình tùy chỉnh với tên đã cho.

abstract ICredentialFactory getCredentialFactory ()

Nhận ICredentialFactory để tạo thông tin xác thực.

abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Trả về DeviceManagementGrpcServer hoặc null nếu không xác định.

abstract IDeviceManager getDeviceManager ()

Nhận IDeviceManager để sử dụng từ cấu hình.

abstract getDeviceMonitors ()

Lấy danh sách IDeviceMonitor từ cấu hình chung.

abstract IDeviceSelection getDeviceRequirements ()

Lấy IDeviceSelection để sử dụng từ cấu hình.

abstract TradefedFeatureServer getFeatureServer ()

Trả về TradefedFeatureServer hoặc null nếu không xác định.

abstract IConfigurationServer getGlobalConfigServer ()

Nhận máy chủ cấu hình toàn cầu.

abstract getHostMonitors ()

Lấy danh sách IHostMonitor từ cấu hình chung.

abstract IHostOptions getHostOptions ()

Nhận IHostOptions để sử dụng từ cấu hình.

abstract IHostResourceManager getHostResourceManager ()

Lấy IHostResourceManager từ cấu hình chung.

abstract IKeyStoreFactory getKeyStoreFactory ()

Lấy IKeyStoreFactory để sử dụng từ cấu hình.

abstract getMultiDeviceRecoveryHandlers ()

Lấy danh sách IMultiDeviceRecovery để sử dụng từ cấu hình.

abstract getOptionValues (String optionName)

Nhận danh sách các giá trị của tùy chọn.

abstract getResourceMetricCollectors ()

Lấy danh sách IResourceMetricCollector từ cấu hình chung.

abstract ISandboxFactory getSandboxFactory ()

Nhận một nhà máy hộp cát có thể được sử dụng để chạy lệnh gọi

abstract IShardHelper getShardingStrategy ()

Trả về IShardHelper xác định cách phân chia cấu hình.

abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Trả về TestInvocationManagementServer hoặc null nếu không xác định.

abstract ITerribleFailureHandler getWtfHandler ()

Lấy ITerribleFailureHandler để sử dụng từ cấu hình.

abstract void injectOptionValue (String optionName, String optionValue)

Đưa một giá trị tùy chọn vào tập hợp các đối tượng cấu hình.

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

Đưa một giá trị tùy chọn vào tập hợp các đối tượng cấu hình.

abstract void setCommandScheduler ( ICommandScheduler scheduler)

Đặt ICommandScheduler , thay thế mọi giá trị hiện có.

abstract void setConfigurationFactory ( IConfigurationFactory configFactory)

Đặt IConfigurationFactory cho cấu hình này.

abstract void setConfigurationObject (String name, Object configObject)

Phương thức chung để đặt đối tượng cấu hình với tên đã cho, thay thế mọi giá trị hiện có.

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

Phương thức chung để đặt danh sách đối tượng cấu hình cho tên đã cho, thay thế mọi giá trị hiện có.

abstract void setDeviceManagementServer ( DeviceManagementGrpcServer server)

Đặt DeviceManagementGrpcServer .

abstract void setDeviceManager ( IDeviceManager deviceManager)

Đặt IDeviceManager , thay thế mọi giá trị hiện có.

abstract void setDeviceMonitor ( IDeviceMonitor deviceMonitor)

Đặt IDeviceMonitor .

abstract void setDeviceRequirements ( IDeviceSelection deviceSelection)

Đặt IDeviceSelection , thay thế mọi giá trị hiện có.

abstract void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Đặt danh sách IHostMonitor .

abstract void setHostOptions ( IHostOptions hostOptions)

Đặt IHostOptions , thay thế mọi giá trị hiện có.

abstract void setHostResourceManager ( IHostResourceManager hostResourceManager)

Đặt IHostResourceManager , thay thế mọi giá trị hiện có.

abstract void setInvocationServer ( TestInvocationManagementServer server)

Đặt TestInvocationManagementServer .

abstract void setKeyStoreFactory ( IKeyStoreFactory factory)

Đặt IKeyStoreFactory , thay thế mọi giá trị hiện có.

abstract setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs)

Đặt các trường Option cấu hình chung với bộ đối số dòng lệnh đã cho

Xem ArgsOptionParser để biết định dạng dự kiến

abstract void setOriginalConfig (String config)

Đặt cấu hình ban đầu được sử dụng để tạo cấu hình chung.

abstract void setResourceMetricCollector ( IResourceMetricCollector collector)

Đặt IResourceMetricCollector .

abstract void setSandboxFactory ( ISandboxFactory factory)

Đặt ISandboxFactory , thay thế mọi giá trị hiện có.

abstract void setShardingStrategy ( IShardHelper sharding)

Đặt IShardHelper để sử dụng khi bảo vệ cấu hình.

abstract void setTradefedFeatureServer ( TradefedFeatureServer server)

Đặt TradefedFeatureServer .

abstract void setWtfHandler ( ITerribleFailureHandler wtfHandler)

Đặt ITerribleFailureHandler .

abstract void setup ()

Thiết lập thích hợp khi bắt đầu giao dịch.

abstract void validateOptions ()

Xác thực các giá trị tùy chọn.

Phương pháp công khai

dọn dẹp

public abstract void cleanup ()

Dọn dẹp đúng cách khi tắt máy.

cloneConfigWithFilter

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

Lọc GlobalConfiguration dựa trên danh sách trắng và xuất ra tệp XML.

Thông số
exclusionPatterns : Mẫu tên lớp cần loại trừ khỏi kết xuất.

allowlistConfigs String : một mảng String gồm các cấu hình được đưa vào tệp XML mới. Nếu nó được đặt thành null , a default list should be used.
Trả lại
File Tệp chứa cấu hình chung được lọc mới.

Ném
IOException

cloneConfigWithFilter

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

Lọc GlobalConfiguration dựa trên danh sách trắng đồng thời cho phép thao tác các giá trị tùy chọn và xuất ra tệp XML.

Thông số
exclusionPatterns : Mẫu tên lớp cần loại trừ khỏi kết xuất.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String : một mảng String gồm các cấu hình được đưa vào tệp XML mới. Nếu nó được đặt thành null , a default list should be used.
Trả lại
File Tệp chứa cấu hình chung được lọc mới.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

Lọc GlobalConfiguration dựa trên danh sách được phép và xuất ra tệp XML.

Ví dụ: đối với cấu hình sau: <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>

tất cả cấu hình ngoại trừ "key_store" sẽ bị lọc ra và tạo ra một tệp cấu hình có nội dung sau: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Thông số
allowlistConfigs String : một mảng String gồm các cấu hình được đưa vào tệp XML mới. Nếu nó được đặt thành null , a default list should be used.
Trả lại
File Tệp chứa cấu hình chung được lọc mới.

Ném
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Lấy ICommandScheduler để sử dụng từ cấu hình.

Trả lại
ICommandScheduler ICommandScheduler . Sẽ không bao giờ trả về giá trị rỗng.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

Lấy đối tượng cấu hình tùy chỉnh với tên đã cho.

Thông số
typeName String : kiểu duy nhất của đối tượng cấu hình

Trả lại
Object đối tượng hoặc null nếu không tìm thấy đối tượng có tên đó

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Nhận ICredentialFactory để tạo thông tin xác thực.

Trả lại
ICredentialFactory ICredentialFactory hoặc null nếu không được chỉ định.

getDeviceQuản lýMáy chủ

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Trả về DeviceManagementGrpcServer hoặc null nếu không xác định.

Trả lại
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Nhận IDeviceManager để sử dụng từ cấu hình. Quản lý bộ thiết bị có sẵn để thử nghiệm

Trả lại
IDeviceManager IDeviceManager được cung cấp trong cấu hình.

getDeviceMonitor

public abstract  getDeviceMonitors ()

Lấy danh sách IDeviceMonitor từ cấu hình chung.

Trả lại
danh sách IDeviceMonitor từ cấu hình chung hoặc null nếu không được chỉ định.

getYêu cầu thiết bị

public abstract IDeviceSelection getDeviceRequirements ()

Lấy IDeviceSelection để sử dụng từ cấu hình. Đại diện cho bộ lọc chung trên các thiết bị mà DeviceManager có thể nhìn thấy.

Trả lại
IDeviceSelection IDeviceSelection được cung cấp trong cấu hình.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Trả về TradefedFeatureServer hoặc null nếu không xác định.

Trả lại
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Nhận máy chủ cấu hình toàn cầu. Máy chủ cấu hình chung được sử dụng để lấy cấu hình máy chủ từ máy chủ thay vì lấy nó từ các tệp cục bộ.

Trả lại
IConfigurationServer

getHostMonitor

public abstract  getHostMonitors ()

Lấy danh sách IHostMonitor từ cấu hình chung.

Trả lại
danh sách IHostMonitor từ cấu hình chung hoặc null nếu không được chỉ định.

gethostOptions

public abstract IHostOptions getHostOptions ()

Nhận IHostOptions để sử dụng từ cấu hình.

Trả lại
IHostOptions IDeviceManager được cung cấp trong cấu hình.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Lấy IHostResourceManager từ cấu hình chung.

Trả lại
IHostResourceManager IHostResourceManager từ cấu hình chung hoặc triển khai mặc định LocalHostResourceManager nếu không có cấu hình nào được chỉ định trong cấu hình máy chủ.

getKeyStoreNhà máy

public abstract IKeyStoreFactory getKeyStoreFactory ()

Lấy IKeyStoreFactory để sử dụng từ cấu hình.

Trả lại
IKeyStoreFactory IKeyStoreFactory hoặc null nếu không có nhà máy lưu trữ khóa nào được đặt.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

Lấy danh sách IMultiDeviceRecovery để sử dụng từ cấu hình.

Trả lại
danh sách IMultiDeviceRecovery hoặc null nếu không được đặt.

getOptionValues

public abstract  getOptionValues (String optionName)

Nhận danh sách các giá trị của tùy chọn.

Thông số
optionName String : tên tùy chọn bản đồ

Trả lại
danh sách các giá trị của tùy chọn đã cho. null nếu tên tùy chọn không tồn tại.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Lấy danh sách IResourceMetricCollector từ cấu hình chung.

Trả lại
danh sách IResourceMetricCollector từ cấu hình chung hoặc null nếu không được chỉ định.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Nhận một nhà máy hộp cát có thể được sử dụng để chạy lệnh gọi

Trả lại
ISandboxFactory

getShardingChiến lược

public abstract IShardHelper getShardingStrategy ()

Trả về IShardHelper xác định cách phân chia cấu hình.

Trả lại
IShardHelper

getTestInvocationQuản lýSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Trả về TestInvocationManagementServer hoặc null nếu không xác định.

Trả lại
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Lấy ITerribleFailureHandler để sử dụng từ cấu hình. Xử lý những việc cần làm trong trường hợp xảy ra WTF (Thất bại khủng khiếp).

Trả lại
ITerribleFailureHandler ITerribleFailureHandler được cung cấp trong cấu hình hoặc null nếu không có trình xử lý nào được đặt

tiêmOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Đưa một giá trị tùy chọn vào tập hợp các đối tượng cấu hình.

Hữu ích để cung cấp giá trị cho các tùy chọn được tạo động.

Thông số
optionName String : tên tùy chọn

optionValue String : (các) giá trị tùy chọn

Ném
ConfigurationException nếu không đặt được giá trị của tùy chọn

tiêmOptionValue

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

Đưa một giá trị tùy chọn vào tập hợp các đối tượng cấu hình.

Hữu ích để cung cấp giá trị cho các tùy chọn được tạo động.

Thông số
optionName String : tên tùy chọn bản đồ

optionKey String : phím tùy chọn bản đồ

optionValue String : giá trị tùy chọn bản đồ

Ném
ConfigurationException nếu không đặt được giá trị của tùy chọn

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Đặt ICommandScheduler , thay thế mọi giá trị hiện có.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Đặt IConfigurationFactory cho cấu hình này.

Thông số
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

Phương thức chung để đặt đối tượng cấu hình với tên đã cho, thay thế mọi giá trị hiện có.

Thông số
name String : tên duy nhất của loại đối tượng cấu hình.

configObject Object : đối tượng cấu hình

Ném
ConfigurationException nếu configObject không đúng loại

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

Phương thức chung để đặt danh sách đối tượng cấu hình cho tên đã cho, thay thế mọi giá trị hiện có.

Thông số
typeName String : tên duy nhất của loại đối tượng cấu hình.

configList : danh sách đối tượng cấu hình

Ném
ConfigurationException nếu bất kỳ đối tượng nào trong danh sách không đúng loại

setDeviceQuản lýMáy chủ

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Đặt DeviceManagementGrpcServer .

Thông số
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

Đặt IDeviceManager , thay thế mọi giá trị hiện có. Điều này đặt trình quản lý cho các thiết bị thử nghiệm

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Đặt IDeviceMonitor .

Thông số
deviceMonitor IDeviceMonitor : Màn hình

Ném
ConfigurationException nếu IDeviceMonitor đã được đặt.

setDeviceYêu cầu

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Đặt IDeviceSelection , thay thế mọi giá trị hiện có. Điều này đặt bộ lọc thiết bị chung trên những thiết bị mà DeviceManager có thể nhìn thấy.

setHostMonitor

public abstract void setHostMonitors ( hostMonitors)

Đặt danh sách IHostMonitor .

Thông số
hostMonitors : Danh sách màn hình

Ném
ConfigurationException nếu IHostMonitor đã được đặt.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Đặt IHostOptions , thay thế mọi giá trị hiện có.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Đặt IHostResourceManager , thay thế mọi giá trị hiện có.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Đặt TestInvocationManagementServer .

Thông số
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Đặt IKeyStoreFactory , thay thế mọi giá trị hiện có.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

Đặt các trường Option cấu hình chung với bộ đối số dòng lệnh đã cho

Xem ArgsOptionParser để biết định dạng dự kiến

Thông số
listArgs : các đối số dòng lệnh

Trả lại
những lý lẽ không được sử dụng

Ném
ConfigurationException

setOriginalConfig

public abstract void setOriginalConfig (String config)

Đặt cấu hình ban đầu được sử dụng để tạo cấu hình chung.

Thông số
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

Đặt IResourceMetricCollector .

Thông số
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

Đặt ISandboxFactory , thay thế mọi giá trị hiện có.

setShardingChiến lược

public abstract void setShardingStrategy (IShardHelper sharding)

Đặt IShardHelper để sử dụng khi bảo vệ cấu hình.

Thông số
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Đặt TradefedFeatureServer .

Thông số
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Đặt ITerribleFailureHandler .

Thông số
wtfHandler ITerribleFailureHandler : trình xử lý WTF

Ném
ConfigurationException nếu ITerribleFailureHandler đã được đặt.

cài đặt

public abstract void setup ()

Thiết lập thích hợp khi bắt đầu giao dịch.

Ném
com.android.tradefed.config.ConfigurationException
ConfigurationException

xác thựcOptions

public abstract void validateOptions ()

Xác thực các giá trị tùy chọn.

Hiện tại điều này sẽ chỉ xác nhận rằng tất cả các tùy chọn bắt buộc đã được đặt

Ném
ConfigurationException nếu cấu hình thiếu các trường bắt buộc