2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
↳	com.android.tradefed.invoker.InvocationContext

IInvocationContext의 일반 구현입니다.

요약

공개 생성자
`InvocationContext()` 기본 속성 값을 사용하여 `BuildInfo`를 만듭니다.

공개 메서드
`void`	`addAllocatedDevice(Map<String, ITestDevice> deviceWithName)` `ITestDevice`와 연결된 구성 기기 이름의 지도를 추적합니다.
`void`	`addAllocatedDevice(String devicename, ITestDevice testDevice)` 기기가 할당될 때 메타데이터에서 추적할 ITestDevice 추가
`void`	`addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)` 기기 구성 이름과 함께 추적할 `IBuildInfo`를 추가합니다.
`void`	`addInvocationAttribute(String attributeName, String attributeValue)` 호출 속성을 추가합니다.
`void`	`addInvocationAttributes(MultiMap<String, String> attributesMap)` `UniqueMultiMap`를 통해 여러 호출 속성을 한 번에 추가합니다.
`void`	`addSerialsFromShard(Integer index, List<String> serials)` 일부 테스트를 실행하는 샤드 중 하나에 할당된 것으로 추적할 시리얼을 추가합니다.
`static InvocationContext`	`fromProto(InvocationContext.Context protoContext)` 인스턴스를 다시 가져오기 위해 `InvocationContext.toProto()`의 역 연산입니다.
`MultiMap<String, String>`	`getAttributes()` 모든 호출 속성이 포함된 맵의 복사본을 반환합니다.
`IBuildInfo`	`getBuildInfo(String deviceName)` 제공된 기기 구성 이름과 연결된 `IBuildInfo`을 반환합니다.
`IBuildInfo`	`getBuildInfo(ITestDevice testDevice)` `ITestDevice`와 연결된 `IBuildInfo` 반환
`String`	`getBuildInfoName(IBuildInfo info)` `IBuildInfo`에서 xml 구성의 기기 세트 이름을 반환합니다.
`List<IBuildInfo>`	`getBuildInfos()` 이 호출에 대해 추적된 모든 `IBuildInfo`를 반환합니다.
`ConfigurationDescriptor`	`getConfigurationDescriptor()` 호출을 실행한 테스트 구성과 연결된 설명자를 반환합니다.
`ITestDevice`	`getDevice(String deviceName)` 제공된 기기 구성 이름과 연결된 `ITestDevice`을 반환합니다.
`Map<ITestDevice, IBuildInfo>`	`getDeviceBuildMap()` 기기/빌드 정보 연결 맵을 반환합니다.
`ITestDevice`	`getDeviceBySerial(String serial)` 제공된 일련번호와 연결된 `ITestDevice`을 반환합니다.
`List<String>`	`getDeviceConfigNames()` 이 호출에서 추적된 기기의 기기 구성 이름 목록을 반환합니다.
`String`	`getDeviceName(ITestDevice device)` `ITestDevice`의 xml 구성에서 기기 세트의 이름을 반환합니다.
`List<ITestDevice>`	`getDevices()` 이 호출에 할당된 모든 기기를 반환합니다.
`String`	`getInvocationId()`
`IInvocationContext`	`getModuleInvocationContext()` 스위트의 일부로 실행되는 동안 모듈의 호출 컨텍스트를 반환합니다.
`int`	`getNumDevicesAllocated()` 호출에 할당된 기기 수를 반환합니다.
`List<String>`	`getSerials()` 이 호출에서 추적된 기기의 일련번호 목록을 반환합니다.
`Map<Integer, List<String>>`	`getShardsSerials()` 추적된 모든 일련번호와 샤딩에 관련된 샤드의 맵을 반환합니다.
`String`	`getTestTag()` 호출 테스트 태그를 반환합니다.
`static boolean`	`isApiTrigger(IInvocationContext context)` 트리거 유형에 따라 API 기반 테스트 호출이 감지되는지 여부를 반환합니다.
`static boolean`	`isOnDemand(IInvocationContext context)` 트리거 유형에 따라 주문형 테스트 호출을 감지하는지 여부를 반환합니다.
`static boolean`	`isPresubmit(IInvocationContext context)` 트리거 유형에 따라 사전 제출을 감지하는지 여부를 반환합니다.
`void`	`lockAttributes()` 더 많은 호출 속성이 추가되지 않도록 컨텍스트를 잠급니다.
`void`	`logInvocationMetrics()` `InvocationMetricLogger` 속성을 호출에 로깅합니다.
`void`	`markReleasedEarly()` 기기가 조기 출시된다고 표시합니다.
`void`	`setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)` 호출을 시작한 테스트 구성과 연결된 설명자를 설정합니다.
`void`	`setModuleInvocationContext(IInvocationContext invocationContext)` 도구 모음의 일부로 실행되는 동안 모듈의 호출 컨텍스트를 설정합니다.
`void`	`setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)` 컨텍스트에 속한 모든 기기의 `RecoveryMode`를 설정합니다.
`void`	`setTestTag(String testTag)` 호출 테스트 태그를 설정합니다.
`InvocationContext.Context`	`toProto()` 컨텍스트 인스턴스를 protobuf로 직렬화합니다.
`boolean`	`wasReleasedEarly()` 기기가 조기 출시되어 더 이상 사용되지 않는지 여부를 반환합니다.

공개 생성자

InvocationContext

public InvocationContext ()

기본 속성 값을 사용하여 BuildInfo를 만듭니다.

공개 메서드

addAllocatedDevice

public void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

ITestDevice와 연결된 구성 기기 이름의 지도를 추적합니다. 추가하기 전에 이전 추적을 지우지 않습니다.

매개변수
`deviceWithName`	`Map`: 추적할 추가 기기의 `Map`

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

기기가 할당될 때 메타데이터에서 추적할 ITestDevice 추가 지도에서 빌드 정보를 null로 설정합니다.

매개변수
`devicename`	`String`: `ITestDevice`와 연결할 기기 구성 이름
`testDevice`	`ITestDevice`: 할당된 기기에 추가됩니다.

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

기기 구성 이름과 함께 추적할 IBuildInfo를 추가합니다.

매개변수
`deviceName`	`String`: 기기 구성 이름
`buildinfo`	`IBuildInfo`: 기기 구성 이름과 연결된 `IBuildInfo`입니다.

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

호출 속성을 추가합니다.

매개변수
`attributeName`	`String`
`attributeValue`	`String`

addInvocationAttributes

public void addInvocationAttributes (MultiMap<String, String> attributesMap)

UniqueMultiMap를 통해 여러 호출 속성을 한 번에 추가합니다.

매개변수
`attributesMap`	`MultiMap`

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                List<String> serials)

일부 테스트를 실행하는 샤드 중 하나에 할당된 것으로 추적할 시리얼을 추가합니다.

매개변수
`index`	`Integer`: 일련번호를 사용하는 샤드의 색인
`serials`	`List`: 추적할 일련번호 목록입니다.

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

인스턴스를 다시 가져오기 위해 InvocationContext.toProto()의 역 연산입니다.

매개변수
`protoContext`	`InvocationContext.Context`

반환
`InvocationContext`

getAttributes

public MultiMap<String, String> getAttributes ()

모든 호출 속성이 포함된 맵의 복사본을 반환합니다.

반환
`MultiMap<String, String>`

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

제공된 기기 구성 이름과 연결된 IBuildInfo을 반환합니다. deviceName이 일치하지 않으면 null을 반환합니다.

매개변수
`deviceName`	`String`

반환
`IBuildInfo`

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

ITestDevice와 연결된 IBuildInfo 반환

매개변수
`testDevice`	`ITestDevice`

반환
`IBuildInfo`

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

IBuildInfo에서 xml 구성의 기기 세트 이름을 반환합니다. IBuildInfo가 일치하지 않으면 null을 반환합니다.

매개변수
`info`	`IBuildInfo`

반환
`String`

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

이 호출에 대해 추적된 모든 IBuildInfo를 반환합니다.

반환
`List<IBuildInfo>`

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

호출을 실행한 테스트 구성과 연결된 설명자를 반환합니다.

반환
`ConfigurationDescriptor`

getDevice

public ITestDevice getDevice (String deviceName)

제공된 기기 구성 이름과 연결된 ITestDevice을 반환합니다.

매개변수
`deviceName`	`String`

반환
`ITestDevice`

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

기기/빌드 정보 연결 맵을 반환합니다.

반환
`Map<ITestDevice, IBuildInfo>`

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

제공된 일련번호와 연결된 ITestDevice을 반환합니다. 가장 빠른 조회는 아니므로 너무 많이 사용하지 마세요.

매개변수
`serial`	`String`

반환
`ITestDevice`

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

이 호출에서 추적된 기기의 기기 구성 이름 목록을 반환합니다.

반환
`List<String>`

getDeviceName

public String getDeviceName (ITestDevice device)

ITestDevice의 xml 구성에서 기기 세트의 이름을 반환합니다. ITestDevice를 매칭할 수 없는 경우 null을 반환합니다.

매개변수
`device`	`ITestDevice`

반환
`String`

getDevices

public List<ITestDevice> getDevices ()

이 호출에 할당된 모든 기기를 반환합니다.

반환
`List<ITestDevice>`

getInvocationId

public String getInvocationId ()

반환
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

스위트의 일부로 실행되는 동안 모듈의 호출 컨텍스트를 반환합니다.

반환
`IInvocationContext`

getNumDevicesAllocated

public int getNumDevicesAllocated ()

호출에 할당된 기기 수를 반환합니다.

반환
`int`

getSerials

public List<String> getSerials ()

이 호출에서 추적된 기기의 일련번호 목록을 반환합니다.

반환
`List<String>`

getShardsSerials

public Map<Integer, List<String>> getShardsSerials ()

추적된 모든 일련번호와 샤딩에 관련된 샤드의 맵을 반환합니다. 샤드 호출이 아닌 경우 비어 있습니다.

반환
`Map<Integer, List<String>>`

getTestTag

public String getTestTag ()

호출 테스트 태그를 반환합니다.

반환
`String`

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

트리거 유형에 따라 API 기반 테스트 호출이 감지되는지 여부를 반환합니다.

매개변수
`context`	`IInvocationContext`

반환
`boolean`

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

트리거 유형에 따라 주문형 테스트 호출을 감지하는지 여부를 반환합니다.

매개변수
`context`	`IInvocationContext`

반환
`boolean`

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

트리거 유형에 따라 사전 제출을 감지하는지 여부를 반환합니다.

매개변수
`context`	`IInvocationContext`

반환
`boolean`

lockAttributes

public void lockAttributes ()

더 많은 호출 속성이 추가되지 않도록 컨텍스트를 잠급니다.

logInvocationMetrics

public void logInvocationMetrics ()

InvocationMetricLogger 속성을 호출에 로깅합니다.

markReleasedEarly

public void markReleasedEarly ()

기기가 조기 출시된다고 표시합니다.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

호출을 시작한 테스트 구성과 연결된 설명자를 설정합니다.

매개변수
`configurationDescriptor`	`ConfigurationDescriptor`

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

도구 모음의 일부로 실행되는 동안 모듈의 호출 컨텍스트를 설정합니다.

매개변수
`invocationContext`	`IInvocationContext`

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

컨텍스트에 속한 모든 기기의 RecoveryMode를 설정합니다.

매개변수
`mode`	`ITestDevice.RecoveryMode`

setTestTag

public void setTestTag (String testTag)

호출 테스트 태그를 설정합니다.

매개변수
`testTag`	`String`

toProto

public InvocationContext.Context toProto ()

컨텍스트 인스턴스를 protobuf로 직렬화합니다.

반환
`InvocationContext.Context`

wasReleasedEarly

public boolean wasReleasedEarly ()

기기가 조기 출시되어 더 이상 사용되지 않는지 여부를 반환합니다.

반환
`boolean`