Evernote API — Small Maven Problem

Posted by & filed under , , .

evernoteSo I started looking a bit closer these days at the Evernote API — another platform alongside Twitter which I like a lot, which is to say it’s basically another platform I find myself writing all sorts of tiny apps around 🙂 From the beginning I find out right away a small problem in their documentation, and while I hurried up to send them a pull request on Github, I’m not sure how quickly their developers are going to react to that, so I thought I’d save some other Evernote enthusiasts some times to dig around by publishing this here as well.

First of all, I’m using the Evernote Java SDK — which is hosted on Github here: https://github.com/evernote/evernote-sdk-java and you can find the JavaDoc here:  http://dev.evernote.com/doc/reference/javadoc/ . Even more, I’m using Maven/Eclipse as my dev environment. As such, I have tried to follow the instructions on the README file on Github — which is where I found the issue.

Their README states that if you use Maven you could simply use something like this in your pom.xml:

<dependency>
<groupId>com.evernote</groupId>
<artifactId>evernote-api</artifactId>
<version>1.25.0</version>
</dependency>

So I did ! 🙂 Only to get the dreaded message from maven about dependency not found 🙁

Digging a bit into it, I found out looking in the repo (http://repo1.maven.org/maven2/com/evernote/evernote-api/) that they don’t actually use minor versions for their releases — as such, the above should actually be:

<dependency>
<groupId>com.evernote</groupId>
<artifactId>evernote-api</artifactId>
<version>1.25</version>
</dependency>

(i.e. 1.25 rather than 1.25.0)

Having made that small change in my pom.xml all worked good from there on.

I’ve forked their repo (here: https://github.com/liviutudor/evernote-sdk-java) and submitted a pull request from there to their repo to reflect these small docco changes (you can see the pull request on their original repo here: https://github.com/evernote/evernote-sdk-java/pull/18) and hopefully they’ll merge it soon and stop this small confusions. However, until Evernote does so hopefully this entry helps all devs out there playing with their Java/Maven SDK.

 

One Response to “Evernote API — Small Maven Problem”

  1. Liv

    Update on this as of Sunday, 13th of October 2013 I have received a heads-up from Evernote — many thanks to Kentaro Suzuki for taking the time to look at this pull request:

    “Thank you for this pull request. What you described in your change is right. Although, we recommend developers to use the latest version and we’ll use Version.Major.Minor from 1.25.1 so I just changed 1.25 to 1.25.1 in README. Thanks again.”

    It makes perfect sense — rather than a whole change with the blur that I put in my pull request, simply update the version number in the docco to 1.25.1!

    As such I will be deleted the forked repo in my github soon so some of the links above will render invalid.