Version 1.38.0 (2023-06-21)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.37.0 (2023-05-10)

Breaking & behavioral changes

None.

New APIs and capabilities

Streetscape Geometry

Streetscape Geometry is a new ARCore Geospatial API that provides the geometry of buildings and terrain in an area around the user when the Geospatial API is enabled.

See Streetscape Geometry Developer Guide (iOS) for more information. Additionally, the GeospatialExample app has been updated to include Streetscape Geometry.

• GARStreetscapeGeometry:
  • GARStreetscapeGeometry.mesh provides 3D meshes.
  • GARStreetscapeGeometry.meshTransform provides the origin transform of the geometry relative to the session's world space.
  • GARStreetscapeGeometry.trackingState maintains the tracking state.
  • GARStreetscapeGeometry.type indicates if it is terrain or building geometry.
  • GARStreetscapeGeometry.quality provides the quality of geometry.
  • GARStreetscapeGeometry.identifier provides the unique identifier for the geometry.
• GARSession.createAnchorOnStreetscapeGeometry:transform:error: creates an anchor at the specified location and orientation.
• GARSession.raycastStreetscapeGeometry:direction:error: performs a raycast against Streetscape Geometry loaded in the scene.

Rooftop anchors

Rooftop anchors are a new Geospatial anchor type that helps you anchor content to a rooftop.

See Geospatial anchors (iOS) for more information. Additionally, the GeospatialExample app has been updated to include Rooftop anchors.

• GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error: creates a Rooftop anchor at the specified location, altitude above the rooftop in meters and orientation relative to the Earth.
• GARCreateAnchorOnRooftopFuture holds the asynchronous state of resolving a Rooftop anchor.
• GARRooftopAnchorState describes the state of resolving a Rooftop anchor.

ARCore async APIs

This release introduces new ARCore async APIs to improve ergonomics when working with asynchronous operations, following the Future paradigm.

• Resolving Terrain anchors: Use [GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:] to obtain a [GARCreateAnchorOnTerrainFuture]. The old symbol [GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:] has been deprecated and may be removed in a later version of ARCore.
• Resolving Cloud anchors: Use [GARSession.resolveCloudAnchorWithIdentifier:completionHandler:error:] to obtain a [GARResolveCloudAnchorFuture]. The old symbol [GARSession.resolveCloudAnchorWithIdentifier:error:] has been deprecated and may be removed in a later version of ARCore.
• Hosting Cloud anchors: Use [GARSession.hostCloudAnchor:TTLDays:completionHandler:error:] to obtain a [GARHostCloudAnchorFuture]. The old symbols [GARSession.hostCloudAnchor:error:] and [GARSession.hostCloudAnchor:TTLDays:error:] have been deprecated and may be removed in a later version of ARCore.

Deprecations

• With the addition of asynchronous Cloud Anchor and Terrain Anchor methods, the following are now obsolete and deprecated:
  • GARAnchor(Geospatial)
  • GARAnchor.terrainState
  • GARTerrainAnchorStateTaskInProgress
  • GARAnchor(CloudAnchors)
  • GARAnchor.cloudIdentifier
  • GARAnchor.cloudState
  • GARCloudAnchorStateTaskInProgress
  • GARSession.hostCloudAnchor:error:
  • GARSession.hostCloudAnchor:TTLDays:error:
  • GARSession.resolveCloudAnchorWithIdentifier:error:
  • GARSessionDelegate
  • GARSessionDelegate.session:didFailToHostAnchor:
  • GARSessionDelegate.session:didHostAnchor:
  • GARSessionDelegate.session:didFailToResolveAnchor:
  • GARSessionDelegate.session:didResolveAnchor:
  • GARSession.delegate
  • GARSession.delegateQueue
  • GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:

Other changes

• GARFuture is a new base type for async operations with property GARFuture.state and method GARFuture.cancel. GARVPSAvailabilityFuture now extends GARFuture.

Bug fixes

None.

Version 1.36.0 (2023-03-01)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

• The ARCore iOS SDK now officially supports Swift Package Manager. See Enable AR in your iOS app for instructions on how to integrate with ARCore using Swift Package Manager.
• Adds copyright statements added to files that were inadvertently missing them previously.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.35.0 (2022-12-07)

Breaking & behavioral changes

None.

New APIs and capabilities

• All Geospatial transforms now expose their orientation accuracy of the Yaw rotation, replacing heading accuracy.
  • GARGeospatialTransform.orientationYawAccuracy

Deprecations

• GARGeospatialTransform.heading has been deprecated. Please use GARGeospatialTransform.eastUpSouthQTarget instead.
  GARGeospatialTransform.headingAccuracy has been deprecated. Please use GARGeospatialTransform.orientationYawAccuracy instead.

Bug fixes

None.

Other Changes

• ARCore Geospatial API [checkVPSAvailabilityAtCoordinate:completionHandler] will continue to retry silently in the background if it is unable to establish a connection to the ARCore service for 5 seconds.

Version 1.34.0 (2022-10-12)

Breaking & behavioral changes

None.

New APIs and capabilities

• A new ARCore Geospatial API has been added to check for Visual Positioning System (VPS) availability at a specified horizontal position at runtime. This API can be used without an active AR session, for example, to present an "Enter AR" button only when VPS is available. See Check VPS Availability for more information and a usage example.
  • GARSession.checkVPSAvailabilityAtCoordinate:completionHandler:
• Geospatial transforms now expose their orientation in 3D space.
  • GARGeospatialTransform.eastUpSouthQTarget
  • GARSession.geospatialTransformFromTransform:error:
  • GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error:. Note that Geospatial poses obtained from these functions have a heading value set to zero. Instead, use GARGeospatialTransform.eastUpSouthQTarget.

Deprecations

None.

Other changes

• GARGeospatialTransform now exposes orientation data in 3D space through GARGeospatialTransform.eastUpSouthQTarget. The heading components of a Geospatial transform are now only valid for Geospatial transforms obtained from cameraGeospatialTransform; other Geospatial transforms should use the 3D orientation instead.

Bug fixes

• Fixed a bug where the Geospatial API would return auth errors when using
  Signed JWT authentication.

Version 1.33.0 (2022-08-18)

Breaking & behavioral changes

To use Cloud Anchors, you must now enable the
ARCore API
instead of the older
ARCore Cloud Anchor API,
which is now deprecated. To support older app versions, you may enable both
while making the transition. Apps built with ARCore SDK 1.32.0 and lower will
target the older API, while apps built with ARCore SDK 1.33.0 and higher will
target the new API. Note the following:

• The new API uses the domain name arcore.googleapis.com instead of
  arcorecloudanchor.googleapis.com.
• If you are using Signed JWTs to authenticate, you will need to change the
  audience claim to https://arcore.googleapis.com/ for apps built with
  ARCore SDK 1.33.0 and higher.
• If you are using an API Key which is restricted by API, you must allow the
  ARCore API.
• If you send requests to the ARCore Cloud Anchor Management API from your
  backend, you must also change the domain name to arcore.googleapis.com, after
  enabling the ARCore API.
• The old API/endpoint will continue to be supported through August 2023.
• See ARCore 1.33 Cloud Anchor endpoint changes for more details.

New APIs and capabilities

ARCore Geospatial Terrain anchor API creates an anchor at a specified horizontal position and altitude relative to the horizontal position’s terrain.

• GARAnchor.terrainState
  Describes the current Terrain anchor state of GARAnchor.
• GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:
  Creates a Geospatial Terrain anchor at the specified location, altitude
  above the terrain in meters and orientation relative to the Earth.

Deprecations

None.

Other changes

• Updates for Xcode 14 - see Xcode 14 Release Notes:
  • SDK binaries no longer contain bitcode, as Apple has deprecated bitcode.
  • SDK binaries no longer contain 32-bit architectures, as Xcode 14 does not
    support these.
  • The SDK no longer supports deployment targets < 11.0, as Xcode 14 does not
    support these.
• SDK binaries now contain the arm64 simulator architecture for Macs with
  Apple Silicon.
• SDK binaries are now packaged as XCFrameworks.
• The SDK now includes Beta support for Swift Package Manager. See README.md
  for how to integrate with ARCore using Swift Package Manager.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.32.0 (2022-06-24)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.31.0 (2022-05-11)

Breaking & behavioral changes

With this release, you must now configure the GARSession before using Cloud
Anchors (or the new Geospatial API; see below). See the new
GARSessionConfiguration class (and its categories) as well as the new method
GARSession#setConfiguration:error:.

New APIs and capabilities

The new
ARCore Geospatial API
utilizes data from Google Earth 3D models and Street View image data from Google
Maps to enable your app for immersive, global-scale, location-based augmented
reality experiences. This functionality is included in the new Geospatial
podspec.

• GAREarth Provides Earth-relative localization.
  • GAREarth.earthState
    manages error states and conditions.
  • GAREarth.trackingState
    maintains the tracking state, required for geospatial data.
• GARGeospatialTransform
  A representation of a global transform including location, heading, altitude,
  and accuracy estimates.
• GARSession.createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error:
  Creates a geospatial anchor at the specified location and orientation
  relative to the Earth.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.30.0 (2022-03-03)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.29.0 (2021-12-10)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.28.0 (2021-11-03)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.27.0 (2021-09-22)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Fixed a bug in Augmented Faces 1.26.0 where frames were never emitted.

Version 1.26.0 (2021-08-11)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.25.0 (2021-06-17)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Fixed a crash that sometimes occurred when using the currentFrame property
  on GARAugmentedFaceSession.

Version 1.24.0 (2021-05-18)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.23.0 (2021-02-19)

Increased the minimum deployment target to iOS 10.0 (from iOS 9.0).

Known Issues

• The emulator build of ARCore does not support ARM (Apple Silicon) Macs.

Breaking & behavioral changes

• AR-enabled apps built using ARCore SDK 1.11.0 or earlier are no longer able to host or resolve Cloud Anchors. Specifically, Cloud Anchors returned by hostCloudAnchor:error: and resolveCloudAnchorWithIdentifier:error: will always have the state GARCloudAnchorStateErrorInternal.

• Apps built with ARCore SDK 1.12.0 or later are unaffected. Their use of Cloud Anchors APIs is covered by the Cloud Anchors deprecation policy.

New APIs and capabilities

None.

Deprecations

None.

Other changes

• The binary size impact of Cloud Anchors on a compressed arm64-only app
  bundle has been reduced to approximately 500KB.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.22.0 (2020-12-14)

Upcoming breaking change affecting Cloud Anchors apps built using ARCore SDK 1.11.0 or earlier

Beginning in January 2021, AR-enabled apps built using ARCore SDK 1.11.0 or earlier will no longer be able to host or resolve Cloud Anchors. Specifically, Cloud Anchors returned by hostCloudAnchor:error: and resolveCloudAnchorWithIdentifier:error: will always have the state GARCloudAnchorStateErrorInternal.

Apps built with ARCore SDK 1.12.0 or later are unaffected. Their use of Cloud Anchors APIs is covered by the Cloud Anchors deprecation policy.

Known Issues

• The emulator build of ARCore does not support ARM (Apple Silicon) Macs.

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.21.0 (2020-11-09)

Upcoming breaking change affecting Cloud Anchors apps built using ARCore SDK 1.11.0 or earlier

Beginning in January 2021, AR-enabled apps built using ARCore SDK 1.11.0 or earlier will no longer be able to host or resolve Cloud Anchors. Specifically, Cloud Anchors returned by hostCloudAnchor:error: and resolveCloudAnchorWithIdentifier:error: will always have the state GARCloudAnchorStateErrorInternal.

Apps built with ARCore SDK 1.12.0 or later are unaffected. Their use of Cloud Anchors APIs is covered by the Cloud Anchors deprecation policy.

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.20.0 (2020-10-06)

Breaking & behavioral changes

• Beginning in January 2021, AR-enabled apps built using ARCore SDK 1.11.0 or earlier will no longer be able to host or resolve Cloud Anchors. Apps built with ARCore SDK 1.12.0 or later are unaffected. To learn more about this breaking change, and for instructions on how to update your app, see the Cloud Anchors deprecation policy.

New APIs and capabilities

• Added Persistent Cloud Anchors, which let you increase the time-to-live (TTL) of Cloud Anchors to 365 days. With the Cloud Anchor Management API, you can also extend the lifetime of a Cloud Anchor. Use of Persistent Cloud Anchors is covered by the new Cloud Anchors deprecation policy.
  • Use sessionWithError: to replace sessionWithAPIKey: to create a Cloud Anchor with a TTL longer than 24 hours.
  • setAuthToken: passes a token (generated for Persistent Cloud Anchors) to your ARCore session.
  • hostCloudAnchor:TTLDays:error: assigns the number of days for a Cloud Anchor's lifetime.
  • estimateFeatureMapQualityForHosting: returns the estimated quality of the visual features seen by the camera in the preceding seconds.

Deprecations

None.

Other changes

None.

Bug fixes

None.

Version 1.19.0 (2020-08-31)

Breaking & behavioral changes

• Adjusted the generated Swift argument labels of some methods:
  • GARSession.resolveCloudAnchor(withIdentifier:) -> GARSession.resolveCloudAnchor(_:)
  • GARSessionDelegate.session(_:didHostAnchor:) -> GARSessionDelegate.session(_:didHost:)
  • GARSessionDelegate.session(_:didFailToHostAnchor:) -> GARSessionDelegate.session(_:didFailToHost:)

New APIs and capabilities

None.

Deprecations

None.

Other changes

• The CloudAnchors and AugmentedFaces subspecs can now be used at the same time.

Bug fixes

None.

Version 1.18.0 (2020-06-25)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Fixed Cloud Anchors Privacy link in the (CloudAnchorExample) sample app. The incorrect link now redirects to the correct link, so existing apps with the incorrect link don't need to be updated.

Version 1.17.0 (2020-05-19)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

• The binary size of the Cloud Anchors SDK has significantly decreased.
• Bitcode is now supported for Augmented Faces. (Bitcode was already supported for Cloud Anchors.)

Bug fixes

• Various bug fixes and performance improvements.

Version 1.16.0 (2020-03-19)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.15.0 (2020-02-06)

Breaking & behavioral changes

None.

New APIs and capabilities

None.

Deprecations

None.

Other changes

Raised the required minimum iOS SDK version to 13.0.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.14.0 (2019-12-12)

Breaking & behavioral changes

• Removed the Cloud Anchor example from the SDK, so pod try will no longer work on the ARCore CocoaPod. It is still available under Examples on the GitHub repository.

New APIs and capabilities

None.

Deprecations

None.

Other changes

None.

Bug fixes

• Various bug fixes and performance improvements.

Version 1.13.0 (2019-10)

Decreased the minimum deployment target of AugmentedFaces to iOS 9.0 (from 10.0).

Bug fixes and performance improvements.

Version 1.12.0 (2019-09-12)

• The ARCore CocoaPod has been divided into two subspecs, CloudAnchors and AugmentedFaces. AugmentedFaces is new for this release. (These libraries are not yet designed to work together.)

• The AugmentedFaces subspec allows you to implement ARCore's Augmented Faces feature on iOS. To read more about Augmented Faces, see https://developers.google.com/ar/develop/ios/augmented-faces/overview

• The Cloud Anchors feature has changed as follows.

  • The data captured by hostCloudAnchor:error: and uploaded to the ARCore Cloud Anchor API service has changed. See https://developers.google.com/ar/develop/ios/cloud-anchors/overview#how-hosted to learn more.
  • resolveCloudAnchorWithIdentifier:error: will no longer time out or fail when the ARCore Cloud Anchor API service is unreachable or the anchor cannot be immediately resolved. Instead, the API continues to attempt to resolve the provided anchors until they are removed.
    • The ErrorResolvingLocalizationNoMatch and ErrorServiceUnavailable enums in GARCloudAnchorState are now deprecated and will no longer be returned. For hosted anchors only, the new value ErrorHostingServiceUnavailable may be returned.
  • Cloud Anchors is now supported on all ARKit-compatible devices. New devices will be supported immediately with this release.

Version 1.11.0 (2019-08-05)

Increased the minimum deployment target to iOS 9.0 (from iOS 8.0).

Bug fixes and performance improvements.

• Added support for devices:
  • iPod Touch (7th gen).

Version 1.10.0 (2019-06-20)

Bug fixes and performance improvements.

Version 1.9.0 (2019-05-06)

Bug fixes and performance improvements.

• Added support for devices:
  • iPad Mini (5th gen).
  • iPad Air (3rd gen).

Version 1.8.0 (2019-03-28)

ARCore is now robust to tracking resets.

Version 1.7.0 (2019-02-14)

Bug fixes and performance improvements.

Version 1.6.0 (2018-12-06)

Added the ability to target iOS versions prior to 11.0. The binary now contains
32-bit architectures, and the README documents three version numbers: minimum
deployment target, minimum base SDK, and minimum version for runtime support.

• Added support for devices:
  • iPhone: XS, XS Max, XR.
  • iPad Pro: 11 inch, 12.9 inch (3rd gen).

Version 1.5.0 (2018-09-27)

Added the ability for new devices to be supported without an SDK update.

Resolved Issues:

• Fixed an issue where ARCore would not compile if used with Firebase Firestore.

Version 1.4.0 (2018-08-02)

Resolved Issues:

• Fixed an issue where hosting and resolving Cloud Anchors would fail on iOS 12 with the new 4:3 aspect ratio.
• Fixed an issue where ARCore would not compile if used with Firebase Messaging.

Version 1.3.0 (2018-06-21)

Adds support for ARKit-compatible iPads. These include:

• iPad: 5th and 6th generation
• iPad Pro: 12.9 inch (1st and 2nd gen), 10.5 inch, 9.7 inch

Resolved Issues:

• Fixed an issue where an invalid API key for the ARCore Cloud Anchor Service would result in a cloud anchor state of GARCloudAnchorStateErrorInternal. The error state will now be GARCloudAnchorStateErrorNotAuthorized.

Version 1.2.1 (2018-05-30)

Resolved Issues:

• Removed SDK references to ARFaceAnchor. The hostCloudAnchor: implementation no longer checks that the passed in ARAnchor is not an ARFaceAnchor, and no longer forcibly exits with GARSessionErrorCodeAnchorNotSupportedForHosting. However, use of ARFaceAnchors remains unsupported in this release.

Version 1.2.0 (2018-05-08)

Initial release alongside ARCore 1.2 on Android.

• Support for Cloud Anchors.
• Supported devices: iPhone X, 8, 8+, 7, 7+, 6S, 6S+, SE.

Known Issues:

• An invalid API key for the ARCore Cloud Anchor Service will result in a Cloud Anchor state of GARCloudAnchorStateErrorInternal instead of GARCloudAnchorStateErrorNotAuthorized. This is a known issue and will be fixed in an upcoming release.