Hello all!
I have finished a first version of synchronization for AnkiDroid and as far as I tested it works fine. But like a thousand users are likely to test far better than me alone, I would like to ask you for your help in testing it and making sure everything works perfect.
If we want to have synchronization in a production release soon enough, this phase of intensive testing is needed, because the last thing I would like is to screw up some user's deck.
So, the steps needed to test this version of AnkiDroid are the next:
- Uninstalling your current AnkiDroid:
- On the Android desktop, press the "Menu" button.
- Touch "Settings"
- Touch "Applications"
- Touch "Manage applications"
- Find and touch "AnkiDroid"
- Touch "Uninstall"
- Installing the new version with synchronization:
- Download the .apk from here
http://ankidroid.googlecode.com/files/AnkiDroid-0.5alpha1-sync-EXPERIMENTAL.apk
- Put the experimental .apk on the sdcard in your phone
- Activate the option "Unknown sources", under Settings -> Applications
- Download from Android Market the application "ASTRO File Manager" (just
look for "Astro")
- Open Astro and look for the file you have just copied on your sdcard
- Click it, open App Manager and install
Be aware that this first version of synchronization lacks some things, that I will implement next days along with the new design. I am just making it available right now because most part of the functionality it is already available and I wanted to share it with you. So right now it can't download a personal deck, there are no error controls for the connections and the options "Sync on open" and "Sync on close" don't do anything.
Also, do not use your main decks, don't risk it.
How to test?
For everyone:
The idea is observe how Anki Desktop works along with AnkiOnline and see if AnkiDroid works in the same way.
- Grab a deck (create a new one, copy one of your decks or get the 'country-capitals' deck that AnkiDroid generates) and have two copies available of the selected deck
- Open one of these copies with Anki Desktop and the other one with AnkiDroid
- Synchronize the deck opened with Anki Desktop to AnkiOnline (without modifying it or making any review)
- Open AnkiDroid and load the other copy of the selected deck
- Select 'Menu' > 'Preferences', and introduce your username and password
- Go to 'Menu' > 'Deck Properties' and click on 'Synchronize this deck'
- Introduce the name that the deck will have on AnkiOnline (choose a different name than the one Anki Desktop synchronized, because if not it is going to be overrided)
- Select 'Menu' > 'More' > 'Synchronize'
- Go check that the deck is correctly uploaded to AnkiOnline
- From now on, perform the exactly same serie of reviews, editings or addings of cards both on Anki Desktop/AnkiDroid or for the two decks on AnkiOnline
- Sync both Anki Desktop and AnkiDroid and see if everything is consistent
This is only a basic example about how to perform a test. I am sure that you are going to come up with a lot more than that.
For advanced users:
If you want to check if AnkiDroid updates cards, reviews and statistics in the exactly same way than Anki Desktop does and you know how to build and execute Anki Desktop from code and a little Python, there is even another way to test sync.
- Go to sync.py on ankiqt and look for the next line: "res = client.server.applyPayload(payload)"
- Modify sync.py in order to save res to a file called "jsonObjectPython.txt" (you can print res and copy it to a file manually)
- Use a copy of the deck you want to test both for Anki Desktop and AnkiDroid
- Start a synchronization test between this modified Anki Desktop and AnkiOnline
- Every time there is something to synchronize from AnkiOnline to Anki Desktop, there will be a payload reply and res it is going to be saved to the file we indicated
- Grab this file and copy it to /sdcard on your phone
- On AnkiDroid, select 'Menu' > 'Sync from payload' (it will synchronize using the same reply that Anki Desktop applied)
- Check if the two decks are equal (
http://ichi2.net/anki/wiki/ContributeToAnkiDroid, section 'Checking Database Modifications')
Sorry for this long mail but there was a lot to explain.
Thank you all for your attention and support! And... happy testing! :D
Edu Zamora
PS: Big thanks to Damien for all his help and support.
--
You received this message because you are subscribed to the Google Groups "AnkiDroid" group.
To post to this group, send an email to
anki-a...@googlegroups.com.
To unsubscribe from this group, send email to
anki-android...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/anki-android?hl=en-GB.