<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Metal",
  "identifier" : "/documentation/Metal/MTL4CompilerTaskOptions/lookupArchives",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Metal"
    ],
    "preciseIdentifier" : "c:objc(cs)MTL4CompilerTaskOptions(py)lookupArchives"
  },
  "title" : "lookupArchives"
}
-->

# lookupArchives

An array of archive instances that can potentially accelerate a compilation task.

```
var lookupArchives: [any MTL4Archive]? { get set }
```

## Discussion

The compiler can reduce the runtime of a compilation task if it finds an entry
that matches a function description within any of the archives in this array.
The compiler searches the archives in the order of the array’s element.

Consider adding archives to the array in scenarios that can benefit from the runtime savings,
such as repeat builds or when your app can share compilation results across multiple contexts.

> Important: Only add ``doc://com.apple.metal/documentation/Metal/MTL4Archive`` instances to the array that are compatible with the Metal device.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)