Раз уж вы читаете этот пост, то, наверное, знаете, что такое Evernote. Ну и конечно же вы знаете, что такое Qt :)
И, может быть, вы, как и я, захотели их объединить.
Если вы пробовали осуществить такое объединение — написать программу на C++/Qt, которая бы обращалась к Evernote Cloud API — то вы уже знаете, что дело это, мягко говоря, нетривиальное. Для C++ создатели Evernote предлагают только сгенерированные компилятором Thrift файлики. От них до чего-то хоть как-то работающего — как до Луны, и, к сожалению, отнюдь не по прямой.
Я этот путь прошел и по результатам этого памятного путешествия решил, что в этот путь людей посылать — оно не очень гуманно. Так что в конце концов я написал свою библиотеку и выложил ее на GitHub.
Чем QEverCloud лучше Evernote SDK?
- Зависит только от Qt. Никаких танцев с бубнами при компиляции.
- Интерфейс библиотеки насколько возможно избавлен от технических деталей. Пользоваться ей настолько просто, насколько это имхо возможно.
- Реализована аутентификация через OAuth.
- Поскольку для реализации клиента HTTP используется QtNetwork, то нет никаких проблем с поддержкой HTTP proxy.
В качестве примера использования вот простенькая программка, которая создает тестовую заметку в блокноте по умолчанию:
#include <QCoreApplication> #include <QTextStream> #include <exception> #include <QEverCloud.h> using namespace qevercloud; int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); QTextStream cout(stdout); try { NoteStore* ns = new NoteStore(&a); // вставьте сюда свой developer token // https://www.evernote.com/api/DeveloperToken.action ns->setAuthenticationToken("S=s41:U=427a0c:E=14761d37b39:C=1400a224f39:P=1cd:A=en-devtoken:V=2:H=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); // там же узнайте свой NoteStore URL ns->setNoteStoreUrl("https://www.evernote.com/shard/xxx/notestore"); Note note; note.title = "Тестовая заметка"; note.content = QString("<?xml version="1.0" encoding="UTF-8"?>n") + "<!DOCTYPE en-note SYSTEM "http://xml.evernote.com/pub/enml2.dtd">n" + "<en-note>" + "<b>Хорошо живет на свете Винни-Пух!</b><br /><br /><p>Хм, похоже, <a href="https://github.com/mgsxx/QEverCloud">QEverCloud</a> таки да работает...</p>" + "</en-note>"; ns->createNote(note); } catch(const std::exception& e) { cout << "exception occured: " << e.what() << endl; return 1; } catch(...) { cout << "unknown exception occured!" << endl; return 1; } return 0; }
Developer tokens весьма удобны для своих личных программок, но для более серьезных программ необходимо токен и NoteStore URL получать через OAuth авторизацию. С помощью QEverCloud это делается легко:
#include <QEverCloudOAuth.h> ... // consumerKey и consumerSecret получайте тут: https://dev.evernote.com/doc/, кнопка GET AN API KEY EvernoteOAuthDialog d(consumerKey, consumerSecret, "sandbox.evernote.com"); d.setWindowTitle("Логин в Evernote"); if(d.exec() != QDialog::Accepted) { QMessageBox::critical(0, "Ошибка", d.oauthError()); } else { QString authenticationToken = d.oauthResult().authenticationToken; QString noteStoreUrl = d.oauthResult().noteStoreUrl; }
Автор: mgsxx