64bit/Help

General

You will find a reference app, kJams Pro app in the dock / task bar, run that and you'll see what we're trying to re-create in Qt.

After you have gotten preliminary database working, you'll want to turn on Music Stores. To do this, go to kJams->preferences->stores, and check the box above the three music stores, then quit and re-run the app. It will then ask to download the music stores. Note these may or may NOT be shown in the Library playlist. Even if they are, they should not be stored within the Library database, or if they are, then they should auto-purge if you run kJams and the corresponding music store's xml file is gone (ie: the user should be free to delete it between runs). Also, when a music store gets an update, it must be done in such a way that new meta data for an existing song updates the existing song, that no NEW song (with a new ID) is generated. It is okay to lose song IDs if the user manually does this, or if they turn off a music store. A song who's ID is in a music store that is turned off is expected to "just disappear" from all playlists. It's fine to require a restart of the app for this.

In the file system, in your user's Music folder, is the kJams folder. Inside that you'll see "kJams Library" which is a shortcut / alias (henceforth called "alias"). The existing alias points to "kJams Library (current)". This is a small library (of real songs that you can play in the reference app) to get you started with some data. Later when you're ready to test importing a very large library, delete this alias, and make a new alias from "kJams Library (monster)". Rename the alias to be only "kJams Library", then launch kJams, which should now pick up the monster library.

Perforce

The Perforce application is already set up for you. I'll send you your user's password. You can just "break locks" when editing files, and later tell P4 to open them for edit using the command line. The commands for that are:

p4 diff -se "//depot/kJams/..." | p4 -x - edit;
p4 diff -se "//depot/CF/..." | p4 -x - edit;
p4 diff -se "//depot/CFTest/..." | p4 -x - edit;

If you edit something in one of those subtrees, you only need to issue the command for that one subtree. On the mac, you can just type "oemf" (open for edit modified files) and it will issue all three for you.

Never check in any ".pro.user" files, and be aware that you'll get messages like "must resolve #xx before submitting", which you can safely ignore.

Please coordinate with me before you to check in any .pri files

Windows

When the app auto updates, the installer may be caught by your antivirus, you may have to turn off antivirus or white list the kJams installer.

Mac

In the Dock, the kJams app on the far right is the reference (32bit) app. The one just to its left is the app you're building (it can run but only shows a shell). To the left of that is the CFTest app (which only outputs to the console)