Upgrade Evernote SDK versions and migrate between API versions. Use when upgrading SDK, handling breaking changes, or migrating to newer API patterns. Trigger with phrases like "upgrade evernote sdk", "evernote migration", "update evernote", "evernote breaking changes".
!npm list evernote 2>/dev/null || echo 'evernote SDK not installed'
Guide for upgrading Evernote SDK versions, converting callback-based code to Promises, handling breaking changes, and maintaining backward compatibility during gradual migration.
Identify your current SDK version and compare against the latest release. Check the changelog for breaking changes between versions.
# Check installed version
npm list evernote
# Check latest available
npm view evernote version
# View changelog
npm view evernote repository.url
Common breaking changes across Evernote SDK versions:
new Evernote.Note() became new Evernote.Types.Note()Wrap callback-based SDK calls in Promise wrappers for modern async/await usage.
// OLD: Callback pattern
noteStore.getNote(guid, true, false, false, false, (error, note) => {
if (error) return handleError(error);
processNote(note);
});
// NEW: Promise/async pattern
const note = await noteStore.getNote(guid, true, false, false, false);
processNote(note);
Build a compatibility layer that supports both old and new SDK patterns during gradual migration. This allows upgrading module by module instead of a big-bang rewrite.
class EvernoteCompat {
constructor(noteStore) {
this.noteStore = noteStore;
}
// Works with both callback and Promise-based SDK
async getNote(guid, opts = {}) {
const { withContent = true, withResources = false } = opts;
return this.noteStore.getNote(guid, withContent, withResources, false, false);
}
async createNote(title, content, notebookGuid) {
const Note = Evernote.Types?.Note || Evernote.Note;
const note = new Note();
note.title = title;
note.content = content;
if (notebookGuid) note.notebookGuid = notebookGuid;
return this.noteStore.createNote(note);
}
}
Update test assertions for new SDK response shapes. Add tests for the compatibility layer. Run both unit and integration tests against the sandbox.
Add deprecation warnings to old patterns so team members know to use new patterns. Remove after migration is complete.
For the full migration script, compatibility layer, test suite updates, and deprecation system, see Implementation Guide.
EvernoteCompat compatibility layer for gradual migration| Issue | Cause | Solution |
|---|---|---|
Evernote.Note is not a constructor | Old import style after upgrade | Use Evernote.Types.Note |
callback is not a function | Mixed callback/Promise patterns | Use Promise consistently, remove callback arg |
Cannot read property 'then' | Using old callback-only method | Update to Promise-based SDK method |
| Type mismatch | Thrift serialization change | Re-generate types from updated Thrift definitions |
For CI/CD integration, see evernote-ci-integration.
Gradual migration: Wrap existing NoteStore with EvernoteCompat, upgrade SDK version, update modules one at a time to use the new patterns, and remove the compatibility layer when migration is complete.
Callback to async/await: Find all callback-based Evernote API calls using grep -r 'noteStore.*function.*error', convert each to async/await, and update error handling from if (error) to try/catch.