What's new in version 2.1

New Features

NoteNote:

The ArcGIS specific Xcode project templates are no longer available. This is because 3rd party project templates are not officially supported by Xcode. Refer to the Configure a new project topic for information on how to setup your project.

Migrating existing applications from v2.0

Migrating existing applications and projects to use the new API is relatively easy and straight-forward. Where possible, the new API is backwards-compatible and maintains the existing behavior.

XCode Project Changes

  • Security.framework needs to be added to any existing project's frameworks.
  • libz.dylib needs to be added to any existing project's frameworks.

API Semantics Changes

  • The angle property on AGSSimpleMarkerSymbol, AGSPictureMarkerSymbol, AGSPictureFillSymbol, and AGSTextSymbol now rotates the symbol in counter-clockwise direction. Previously it used to be clockwise.

API Syntax Changes

  • The JSONUtility class has been renamed to AGSJSONUtility
  • The Base64 class has been renamed to AGSBase64
  • The methods createFeatureWithType: and createFeatureWithTemplate: on AGSFeatureLayer have been renamed to featureWithType: and featureWithTemplate: to be consistent with objective-c naming conventions for methods that return an auto-released object.
  • The method didFailToLoadLayer:withError: on AGSWebMapDelegate has been deprecated and replaced with didFailToLoadLayer:url:baseLayer:withError:. Please update your delegate to implement this new method instead. The new method provides additional information such as the URL of the layer that failed to load, and whether it was a basemap layer.
  • The method mapView:failedLoadingLayerForLayerView:withError: on AGSMapViewLayerDelegate has been deprecated and replaced with mapView:failedLoadingLayerForLayerView:baseLayer:withError:. Please update your delegate to implement this new method instead. The new method provides information about whether the layer that failed to load was also the basemap layer, in which case the map will be in a suspended state waiting for the basemap layer to be resubmitted, removed, or replaced.
  • The envelope property on AGSMapView has been deprecated and replaced by visibleArea to take into account map rotation.
  • The customActionButton property on AGSPopupsContainerViewController has been deprecated and replaced by actionButton.
  • The API classes, categories, category methods, and header files of the json-framework library included with the ArcGIS library have been namespaced with an "AGS" prefix to prevent conflicts that may arise if additional libraries in your project also bundle json-framework. For example -
    • The category method JSONValue on NSString has been renamed to AGSJSONValue
    • The category method JSONRepresentation on NSObject has been renamed to AGSJSONRepresentation
    • The SBJSonParser class has been renamed to AGSSBJsonParser
12/7/2011