| 1 |
Flickr Uploadr |
|---|
| 2 |
|
|---|
| 3 |
Copyright (c) 2007-2008 Yahoo! Inc. All rights reserved. This library is |
|---|
| 4 |
free software; you can redistribute it and/or modify it under the terms of |
|---|
| 5 |
the GNU General Public License (GPL), version 2 only. This library is |
|---|
| 6 |
distributed WITHOUT ANY WARRANTY, whether express or implied. See the GNU |
|---|
| 7 |
GPL for more details (http://www.gnu.org/licenses/gpl.html) |
|---|
| 8 |
|
|---|
| 9 |
------------------------------------------------------------------------ |
|---|
| 10 |
|
|---|
| 11 |
This guide uses UPLOADR to indicate the root of the Flickr Uploadr |
|---|
| 12 |
source tree on your filesystem. It probably shouldn't contain spaces. |
|---|
| 13 |
|
|---|
| 14 |
You can obtain the Flickr Uploadr source code from either a tarball or |
|---|
| 15 |
from Subversion. |
|---|
| 16 |
|
|---|
| 17 |
Download tarball: |
|---|
| 18 |
http://flickr.com/tools/uploadr/ |
|---|
| 19 |
|
|---|
| 20 |
Checkout from Subversion: |
|---|
| 21 |
$ svn co http://code.flickr.com/svn/trunk/uploadr UPLOADR |
|---|
| 22 |
|
|---|
| 23 |
|
|---|
| 24 |
XULRunner |
|---|
| 25 |
------------------------------------------------------------------------ |
|---|
| 26 |
|
|---|
| 27 |
XULRunner trunk builds: |
|---|
| 28 |
ftp://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/latest-trunk/ |
|---|
| 29 |
|
|---|
| 30 |
Note: You want the version *without* 'sdk' in the name. |
|---|
| 31 |
|
|---|
| 32 |
TODO |
|---|
| 33 |
|
|---|
| 34 |
|
|---|
| 35 |
Gecko SDK |
|---|
| 36 |
------------------------------------------------------------------------ |
|---|
| 37 |
|
|---|
| 38 |
To build the XPCOM components you will need the Gecko SDK: |
|---|
| 39 |
http://developer.mozilla.org/en/docs/Gecko_SDK#Downloading |
|---|
| 40 |
|
|---|
| 41 |
Place the SDK here: |
|---|
| 42 |
UPLOADR/MacUploadr.app/Contents/Resources/gecko-sdk.lin |
|---|
| 43 |
|
|---|
| 44 |
These SDKs are from the Gecko 1.8 series and so are only safe to use |
|---|
| 45 |
if the XPCOM components use only frozen interfaces. Fortunately, |
|---|
| 46 |
Uploadr currently falls into this category. |
|---|
| 47 |
|
|---|
| 48 |
|
|---|
| 49 |
API Keys |
|---|
| 50 |
------------------------------------------------------------------------ |
|---|
| 51 |
|
|---|
| 52 |
You'll need your own API key and secret from Flickr to build Uploadr. |
|---|
| 53 |
These can be obtained at http://flickr.com/services/api/. The key |
|---|
| 54 |
and secret must be placed in flKey.cpp in the spaces provided. Copy |
|---|
| 55 |
flKey.cpp.template to flKey.cpp and insert your keys: |
|---|
| 56 |
|
|---|
| 57 |
UPLOADR/MacUploadr.app/Contents/Resources/components/flKey.cpp.template |
|---|
| 58 |
UPLOADR/MacUploadr.app/Contents/Resources/components/flKey.cpp |
|---|
| 59 |
|
|---|
| 60 |
The API key is stored as a string. The secret is stored as individual |
|---|
| 61 |
characters so it is not easily readable from the binary. |
|---|
| 62 |
|
|---|
| 63 |
There are blocks to keep both a Windows and Mac key/secret in the same |
|---|
| 64 |
source file (you certainly don't have to, though). This is mainly |
|---|
| 65 |
important for the official builds. |
|---|
| 66 |
|
|---|
| 67 |
|
|---|
| 68 |
GraphicsMagick |
|---|
| 69 |
------------------------------------------------------------------------ |
|---|
| 70 |
|
|---|
| 71 |
TODO |
|---|
| 72 |
|
|---|
| 73 |
|
|---|
| 74 |
Exiv2 |
|---|
| 75 |
------------------------------------------------------------------------ |
|---|
| 76 |
|
|---|
| 77 |
Download Exiv2 source from: |
|---|
| 78 |
http://exiv2.org/download.html |
|---|
| 79 |
|
|---|
| 80 |
TODO |
|---|
| 81 |
|
|---|
| 82 |
|
|---|
| 83 |
FFmpeg |
|---|
| 84 |
------------------------------------------------------------------------ |
|---|
| 85 |
|
|---|
| 86 |
TODO |
|---|
| 87 |
|
|---|
| 88 |
|
|---|
| 89 |
Building XPCOM components |
|---|
| 90 |
------------------------------------------------------------------------ |
|---|
| 91 |
|
|---|
| 92 |
If you make any changes to the IDL files defining the XPCOM interfaces, |
|---|
| 93 |
you must increment the BuildID defined in: |
|---|
| 94 |
UPLOADR/MacUploadr.app/Contents/Resources/application.ini |
|---|
| 95 |
|
|---|
| 96 |
TODO |
|---|
| 97 |
|
|---|
| 98 |
|
|---|
| 99 |
Running Flickr Uploadr |
|---|
| 100 |
------------------------------------------------------------------------ |
|---|
| 101 |
|
|---|
| 102 |
TODO |
|---|
| 103 |
|
|---|
| 104 |
|
|---|
| 105 |
Packaging |
|---|
| 106 |
------------------------------------------------------------------------ |
|---|
| 107 |
|
|---|
| 108 |
TODO |
|---|
