Installing the Learn Na'vi App on a jailbroken iPhone/iPad

[Tsulu]

Kaltxì ma smuktu,

to introduce myself, I've so far been one of those read-only members being interested in the Na'vi language. I'm from Germany and dedicate most of my free time to the programming of various applications and servers for different communitys or companys (and I'm a fan of open source software!). Some here might know me from IRC, though I'm not that active there either.
I'm somewhat a computer geek and can call myself a proud owner of those shiny Apple devices; and I just couldn't wait for - hey There's an App for that! - the Learn Na'vi app being released on AppStore. Using the PDF in combination with GoodReader for quick dictionary-lookups is a pain. Those who've tried it know what I'm talking about

So here we go, this tutorial is for those who can't wait for the App to be published in Apple's AppStore.
This tutorial is mainly written for Windows user, however anyone with a bit of computer knowlege can do it on other systems aswell.

Please keep in mind that you can brick your device by jailbreaking it and might need to restore it, and you might void your warrenty. Whatever you do, you're doing it on your own behalf and I'm not responsible for anything going wrong.
Also installing the application manually will, of course, mean that it will not be updated automatically. Once it's out there in AppStore you should delete it and get the AppStore version for automated updates.
This does not work on iPhone 2G as it does not support firmware 4.0!

STEP 1: Jailbreak

You can skip this step if your device is already jailbroken.

Upgrade your device to firmware 4.1 or - if you plan to keep your unlock (if you've unlocked it at all) - to 4.0.2.
The jailbreak for iPad works on 3.2.2.
Jailbreak your iPhone/iPad/iPod using redsn0w (iPhone 3G) or limera1n (any other device).
The applications are pretty self explanatory, if you however need help using them, consider watching a tutorial on YouTube.

STEP 2: Setting up OpenSSH

This is simple and I don't think it requires any pictures.
Note: Some devices deactivate WiFi when entering power-safe mode. Do prevent that from happening (the connection will cut off)

1) Open Cydia
2) Search for OpenSSH, select the package, hit Install and confirm
3) Do the same for the 'Respring' package, you will need it later if you want the app's icon to be displayed correctly
4) Wait for the download to finish, then quit Cydia

STEP 3: Get the device's IP

1) Open the Settings App -> WiFi -> Tap the blue arrow of the network you're connected to
2) Note down what it says at IP-Address
http://www.pqdvd.com/blog/iphone/iphone-tips/how-to-find-the-ip-address-of-your-iphone/

SECURITY NOTE: You should change your iPhone's root password, else anyone might be able to log into your phone and mess with it however he wants (read mail, SMS, photos, etc).
http://justanotheriphoneblog.com/wordpress/2009/11/05/how-to-change-the-iphones-root-password/

STEP 4: Unpack the IPA

1) Download the Learn Na'vi App IPA file from http://code.google.com/p/learn-navi/downloads/list
2) Extract the archive you just downloaded
3) Browse to "LearnNavi App\" change the file extension of LearnNavi.ipa to .zip (resulting in LearnNavi.zip)

If you don't see file extensions, use this tutorial to make them visible:
http://www.fileinfo.com/help/windows-show-extensions.html
You can get that option bar on Vista and up by pressing the Alt key while an explorer window has focus.

3) Open the .zip file, browse to "Payload\" and extract "Learn Navi iPhone App.app" - make sure you extract the directory, not its contents

STEP 5: Installing the .ipa file via WinSCP

1) Download and install WinSCP from http://winscp.net/eng/download.php
On other systems like Mac OS or *nix, use the scp command. See "man scp" for more information on that.
2) Connect to your device

Replace 192.168.178.41 by the IP you noted down above.
MAKE SURE SCP IS SELECTED AS PROTOCOL!

The password is "alpine" unless you changed it above.
Note: Screenshot is German, however the location of the input fields are the same



3) Hit 'Login' (Anmelden)
4) You'll get an error box saying something with "group" command. This is okay, ignore it and click Ok
5) You'll be presented with a screen being similar to this



6) In the directory tree on the left, click "/ <root>"
7) Browse to (click the names in the directory tree ): /private/var/mobile
8 ) Create a directory called "Documents" (use hotkey Ctrl + D or click "New directory" icon). If it already exists, that's fine.
This will ensure that the application can download dictionary updates.
9) Browse to /Applications
10) Drag & drop the "Learn Navi iPhone App.app" directory you just extracted into the file list, confirm and the upload will begin, wait for it to finish, then read on
11) Click on "Learn Navi iPhone App.app" in the file list (should just have been added after you uploaded it) with your right mouse button, select Settings




12) Set the file permissions just as displayed on the screenshot above (or set Octal to 0755) and make sure to check the checkbox saying it should recursively apply them, then hit the OK button
13) Close WinSCP

STEP 6: Almost done!

Start the Respring application you've downloaded from Cydia. This will add the app's icon to SpringBoard.



After you started the App, it will ask you if you want to update the dictionary. Confirm and enjoy!





Even though this tutorial looks huge (well it is, my original intention was to keep this short - well this was before I hit the Preview button ) you should be able to complete it within about 20 minutes if you're good with computers. I tried to keep things as detailed as possible and referred to external tutorials (tested them all) to make this a bit shorter and allow people who already have things set up skip these steps. The screenshots are hosted on my server, bandwidth goes on my account.

If you have any questions regarding the tutorial don't hesitate to ask.
In case you need live support I'm also on the LearnNavi IRC server #na'vi/Tsulu.

Hope it helps

Kìyevame ulte Eywa ayngahu
- Tsulu

[Seze]

This is a pretty good tutorial.  Hopefully the need to go this route to install the App will go away once Apple puts the App in the App Store, still waiting for review btw...

[Nawma_taronyu]

I did it much easier, on my iPod went to www.jailbreakme.com (mobile jailbreaking no pc connection needed)  then simply unpacked the app and dragged it into my iTunes and synced it, works perfectly   

[Tsulu]

Don't you need a patched MobileInstallation file for doing so?
(but hey mine's drag'n'drop too once you've completed the first steps )

[Nawma_taronyu]

yea its basicly the same thing only the Jailbreak method is different, the jailbreakme.com site is currently the best for jailbreaking, (cant do custom boot logo though)

[Tsulu]

You would, but it might be easier to slap on a package from a certain repository and use iTunes as Nawma_taronyu described, rather than fiddling with SSH/SFTP/stuff.

Tewti, I actually didn't know there was a repo hosting those patched files, that will for sure make things easier once 4.2 is out.
What I've so far been reading about patching MobileInstallation covered uploading the file 'manually' via SCP too so I thought whatever, why not directly upload the application.

Regarding jailbreakme.com: This is indeed a pretty awesome exploit (and the so far most user-friendly hack I've ever seen aswell), however it only works up to 4.0.1 (iPhone) and 3.2.1 (iPad), which not everyone out there got. I'm currently on 4.1 (iPhone 3G) and 3.2.2 (iPad), both jailbroken using redsn0w and limera1n. However let's please not turn this thread into a discussion about which jailbreak is better - they all just do one and the same thing: Jailbreaking your shiny Apple device

[Nawma_taronyu]

You would, but it might be easier to slap on a package from a certain repository and use iTunes as Nawma_taronyu described, rather than fiddling with SSH/SFTP/stuff.

Tewti, I actually didn't know there was a repo hosting those patched files, that will for sure make things easier once 4.2 is out.
What I've so far been reading about patching MobileInstallation covered uploading the file 'manually' via SCP too so I thought whatever, why not directly upload the application.

Regarding jailbreakme.com: This is indeed a pretty awesome exploit (and the so far most user-friendly hack I've ever seen aswell), however it only works up to 4.0.1 (iPhone) and 3.2.1 (iPad), which not everyone out there got. I'm currently on 4.1 (iPhone 3G) and 3.2.2 (iPad), both jailbroken using redsn0w and limera1n. However let's please not turn this thread into a discussion about which jailbreak is better - they all just do one and the same thing: Jailbreaking your shiny Apple device

Agreed, (glad to know I can upgrade to 4.1 ios though )

And I do have ssh, I just didnt need to use it, just itunes, I found it odd, I thought I would have to Use Iphone browser for it but I guess not, Ima go upgrade my IOs now...