No breaking changes.
Enhancements
- Closes #288. Adds the ability to modify
offlineTilesEnabler
andofflineTilesEnablerLayer
database name and data store name. - Updates to API and How-to Docs
No breaking changes.
Enhancements
- In reference to #288, added tileLayer.showBlankTiles boolean property to both offlineTilesEnabler and OfflineTilesEnablerLayer.
Minor doc update. Fixed broken link in README.
No breaking changes.
Enhancements
- Adds jshint checking to tile libraries and tpk libraries.
No breaking changes.
Enhancements
- Closes #319. Make TPK support more universal between Chrome and WebView on Android.
Minor doc update. Updates to README.
Minor doc update. Clarifications on how to use the tile libraries and fixed some typos.
No breaking changes.
Enhancements
- OfflineFeaturesManager now overrides layer.hasAttachments property. The override is available after a feature layer has been extended. This fixes an existing bug in the ArcGIS JS API when you create a feature layer from a featureCollectionObject the hasAttachmens property does not get correctly repopulated.
Bug fix
- Fixes issue in offlineFeaturesManager's featureCollection data store when using it with multiple feature layers. Subsequent featureLayerCollections were being stored as arrays instead of objects.
- Minor tweak to appcache-tiles.appcache. It was broken.
No breaking changes.
Enhancements
- Initializes internal featureCollectionObject when a layer is extended.
- Added property
OfflineFeaturesManager.ENABLE_FEATURECOLLECTION
. Default value isfalse
. When enabled this will allow the library to automatically create a snapshot of the feature layer.
No breaking changes.
Enhancements
- Closes #327 - Improved use of keys and indexes in editsStore.js. Minor tweaks at this time.
- Closes #342 - Automates featureCollection management. New method
OfflineFeaturesManager.getFeatureCollections()
.
No breaking changes. Recommended update.
Enhancements
- Fixes sync error when returning online after updating a new edit offline.
No breaking changes.
Enhancements
- Closes #339 - offline update of a new attachment needs to be handled as an ADD.
- Updated offlineAttachmentsSpec.js to test for #339 condition.
This release focused on updating full offline editing capabilities. Recommended update. No breaking changes.
Enhancements
- Added functionality to
offlineFeaturesManager.js
to detect and handle when a feature layer is created using a feature collection. - Addresses browser changes in Chrome 42.x and Firefox 37.x with respect to how they handle HTML/JS apps when going offline and then transitioning back online.
- Updated
appcache-features.html
sample.
Bug Fix
- Closes #336 - problem with appcache-features sample. The application now correctly syncs when going back online after a full offline restart. It also contains improvements in how the app life-cycle is handled.
This release has enhancements and has no breaking changes.
Enhancements
- Added
OfflineFeaturesManager.getFeatureLayerJSONDataStore()
for use in full offline browser restarts.
Closes #323 - Add an FAQ doc.
This release focused on improving the handling of attachments. Has breaking changes.
Enhancements
- Added a new sample attachments-editor-secure.html to demonstrate the pattern for working with secure feature services and attachments.
- Closes #286 - support for secure services (HTTPS) when working with attachments
- Closes #305 - Support both ADD and UPDATE attachment.
- Closes #306 - removes createObjectURL functionality from attachmentsStore. This allows for attachments to be used in full offline scenarios.
- Closes #318 - added OfflineFeaturesManager.ATTACHMENTS_DB_NAME and ATTACHMENTS_DB_OBJECSTORE_NAME.
- Closes #321 - switch offlineFeaturesManager unit test to a different feature service that's attachments enabled.
- Closes #322 - rewrite offlineAttachmentsSpec.
- Closes #324 - attachmentsStore._readFile() can indicate false positives.
- Closes #325 - support DELETE an existing attachment.
- Closes #328 - add layer.resestAttachmentsDatabase().
- Closes #329 - add layer.getAttachmentsUsage().
Breaking Changes
- attachmentsStore.DB_NAME has been renamed to attachmentsStore.dbName to be consistent with editStore.
- attachmentsStore.OBJECTSTORE_NAME has been renamed to attachmentsStore.objectStoreName to be consistent with editStore.
- Added use of the browser's FormData() API along with
FormData.append
. This may cause attachment support to break in certain older browsers. This is a courtesy heads-up because as a rule this library only supports the latest version of Chrome, Firefox and Safari.
Patch release. Recommended update. No breaking changes.
Bug Fixes
- Closes #315 - editsStore.pushEdit() - failed to insert undefined objectId into database.
Recommended update. No breaking changes.
Bug Fixes
- Closes #308 - resetLimitedPhantomGraphicsQueue failing. Could cause fatal errors.
Updates
- Closes #304 - preserve version number in minified builds
- Closes #307 - package.json updated devDependencies
- Updated editsStoreSpec2 to accommodate the fix for #308
- jshint updates:
- jshint now working for /edit directory. Initial step towards piping all files thru jshint!
- jshint fix to attachmentsStore.js - moved "use strict" into function
- jshint fix to OfflineEditNS.js - removed "use strict" & added jshint exception
- Many jshint fixes in offlineFeaturesManager.js
- jshint fix to .jshintrc
- Deleted editsStore_old.js
Closes #301 - OfflineFeaturesManager failed on _validateFeature during an attachment ADD operation.
Minor doc update. Clarification in OfflineFeaturesManager on requiring mode
be set to FeatureLayer.MODE_SNAPSHOT
.
Minor doc update. Added references to attachments documentation. Misc. clarifications.
v2.5 focused on updating OfflineFeaturesManager from using localStorage to IndexedDB. Additional information is available in the API Doc. Feature edit storage capabilities have been increased from 5 MBs to approximately 50 - 100 MBs or more, and the changes made allow for additional functionality and capabilities to be implemented that weren't possible under the previous architecture.**
Closes #292, #289, #285, #281, #280, #275, #261
BREAKING CHANGES: In order to accomplish the v2.5 update the following breaking changes were made. All common EditStore
functionality was migrated to the FeatureLayer so that under most circumstances there is no need to use or access the EditStore
library directly anymore. In fact, as of v2.5 accessing it directly is discouraged.
OfflineFeatureManager.getReadableEdit()
deprecated. UsefeatureLayer.getAllEditsArray()
.editsStore.hasPendingEdits()
deprecated. UsefeatureLayer.pendingEdits()
.editsStore.retrieveEditsQueue()
deprecated. UsefeatureLayer.getAllEditsArray()
.editsStore.getEditsStoreSizeBytes()
deprecated. UsefeatureLayer.getUsage()
.editsStore.getLocalStorageSizeBytes()
deprecated. UsefeatureLayer.getUsage()
.
New Functionality in OfflineFeatureManager
OfflineFeaturesManager.DB_NAME
. Allows you to set the database name of the edits library.OfflineFeaturesManager.DB_OBJECTSTORE_NAME
. Set an internal object store within the database that allows access to a set of data.OfflineFeaturesManager.DB_UID
. IMPORTANT. This tells the database whichid
to use as a unique identifier for each feature service.OfflineFeaturesManager.events.EDITS_SENT
. Updated. Now this event is only triggered when an edit is synced with the server while online.OfflineFeaturesManager.events.EDITS_SENT_ERROR
. Indicates there was an error when syncing with the server. If there was an error, the edit will remain in the database.OfflineFeaturesManager.events.EDITS_ENQUEUED_ERROR
. Indicates an error occurred while trying to store an edit in offline mode.
New Functionality in FeatureLayer When you use OfflineFeatureManager.extend()
to extend a feature layer it will be enabled with the following new functionality:
featureLayer.resetDatabase()
. Full database reset.featureLayer.pendingEditsCount()
. Returns the number of pending edits.featureLayer.getUsage()
. Returns the approximate size of the database and number of edits.featureLayer.getPhantomGraphicsArray()
. Used with offline browser restarts. Returns an array of phantom graphics. Complimentary tofeatureLayer.getPhantomLayerGraphics()
.featureLayer.getAllEditsArray()
. Returns an array of all edits stored in the database.featureLayer.getFeatureLayerJSON()
. A helper function for retrieving a feature layers JSON using the RESTf=json
parameter. Note you can also retrieve feature layer JSON using the ArcGIS API for JavaScript'sfeatureLayer.toJson()
method.featureLayer.setFeatureLayerJSONDataStore()
. Sets or updates the optional feature layer storage object. You can also set the dataStore using theOfflineFeatureManager
constructor'sdataStore
property.featureLayer.getFeatureLayerJSONDataStore()
. Retrieves the optional feature layer storage object.featureLayer.convertFeatureGraphicsToJSON()
. Helper function that converts an array of graphics to a JSON string.
** Footnote on browser storage capabilities. The amount of storage varies from device to device. It depends on multiple factors related to the browser including how much memory space the browser has consumed, how large the browser cache has grown, how many other tabs may be open, and how much memory other applications are already consuming.
- Closes #274 phantom symbols not working correctly
- Updated offlineFeaturesManager.js
- Updated API docs to reflect new functionality.
- Updated appcache-features.html sample to incorporate new functionality.
- Updated modular-popup CSS media queries
New functionality:
- Added setPhantomLayerGraphics() - for use with offline browser restarts. Allows you to restore the phantom graphics layer. This layer is used to highlight any points that have been modified while offline.
- Added getPhantomLayerGraphics() - for use with offline browser restarts. Allows you to get a JSON copy of the current phantom graphics layers so that you can save it to a local database such as localStorage.
Breaking changes: none
- Closes #267 can't host markdown on gh-pages
- Minor wording change in tpk-layer.html sample to better describe changing TPK file type to .zip in order for it to work correctly.
- Fixes NPM version for current NPM (requires patch version)
- Fixes issue with JPEG-based TPKs where tiles were not completely read from the TPK buffer, resulting in an incomplete image.
- Closes #74 - Build sample with nice UX for editing
- Closes #257 - Build getting started pages for AGOL, editing and TPK. All samples show basic functionality and are responsive. Also integrated a new launch page for the API and How To Use docs.
- Closes #258 - Convert modal popup to widget
- The following samples were updated to be responsive:
- appcache-features.html
- appcache-tiles.html
- tpk-layer.html
New functionality:
- Closes #256 - Add getMaxZoom and getMinZoom to offlineTilesEnabler
- Added getMinMaxLOD() to offlineTilesEnabler and OfflineTilesEnablerLayer
Breaking Changes - None.
Added a Getting Started for Tiles tutorial.
Force update of submodules for IndexedDB and offline.js. Didn't take the 1st time. Submodule updates can be tricky.
- Closes #233 - Rename TPKLayer.isDBWriteable()
- Closes #238 - TPKLayer - load tiles from URL
- Closes #242 - Internal - replace certain constructor properties
- Closes #243 - Update vendor versions
- Closes #247 - TPKLayer - only init autoCenter when null
- Closes #248 - Remove resource-proxy sub-directory
- Closes #249 - Add a public proxyPath var to offlineFeaturesManager.js
New functionality:
- Rename TPKLayer.isDBWriteable() to setDBWriteable(boolean). (Issue #233)
- In TPKLayer - load tiles from URL creates a new method loadTilesFromURL(). (Issue #238)
- Adds a public proxyPath var to offlineFeaturesManager.js. (Issue #249)
Breaking change:
- Issue #248 removes the ArcGIS proxy libraries from this repo. This means if you have an application that referred to that directory it will break and you'll need to fork and clone your own version of that repository here.
- Closes #244 - broken attachements-editor sample gh-pages
- Closes #236 - Minor typo in How to use TPKLayer doc
- Closes #237 - Completely rebuilt gh-pages. Now we have an online demo app page.
- Closes issue #234 - Minor cleanup of samples. Removed unused dojoConfig pathnames.
- Documentation update only.
- More minor doc updates.
- Minor README update to include link to new migration tips doc.
- Minor updates to documentation
- Removed VERSION property from namespace (for now)
- Deleted OfflineMapsNS.js - not used (left over from v2 testing)
Version 2.0 involves many changes. Please read the following carefully when upgrading from v1.x to v2.0.
Breaking Changes:
- Provides a single, concatenated and minified library files in /dist for edit, tiles and tpk. This single library pattern offers a HTTP request/response performance boost by providing libraries of significantly smaller size and only one file to retrieve as compared to making multiple HTTP requests.
- Added a new namespacing for use with all non-AMD JavaScript libraries in the repo.
- Internally refactored all libraries.
- Single, concatenated source library files also available in /dist.
- Updated all samples to ArcGIS API for JavaScript v3.10.
- Concatentation and minification of libraries via a Grunt task.
- All tests updated.
- All samples updated.
- Consolidated duplicate functionality between offlineTilesEnabler.js and OfflineTilesEnablerLayer.js into TilesCore.js. The coding pattern is a bit ackward to access the shared functionality, but the upside is that duplicate functionality only needs to be maintained in a single library.
Overview of the new namespace pattern:
O.esri.Edit
references all offline edit librariesO.esri.Tiles
references all offline tile librariesO.esri.TPK
references all TPK librariesO.esri.zip
a wrapper around Zip.js
Breaking name changes for the following libraries:
offline-edit-min.js
- replaces OfflineFeaturesManager.jsoffline-tiles-basic-min.js
- replaces offlineTilesEnabler.jsoffline-tiles-advanced-min.js
- replaces OfflineTilesEnablerLayer.jsoffline-tpk-min.js
- replaces TPKLayer.js
Breaking name changes for the following Classes:
O.esri.Edit.OfflineFeaturesManager()
replaces OfflineFeaturesManager()O.esri.Tiles.OfflineTilesEnabler()
replaces OfflineTilesEnabler()O.esri.Tiles.OfflineTilesEnablerLayer()
replaces OfflineTilesEnablerLayer()O.esri.TPK.TPKLayer()
replaces TPKLayer()O.esri.Edit.EditStore()
replaces editsStore()O.esri.zip
replaces the module "tpk/zip"
Breaking changes for the following methods:
O.esri.Edits.EditStore().retrieveEditsQueue()
replaces the formerly private method _editsStore().retrieveEditsQueue()
Deprecations:
- Deprecated restartOfflineFeaturesManager.js. This functionality has been integrated directly into
OfflineFeaturesManager.js
- Multiple, non-versioned updates
- Initial commit.