The Mer Wiki now uses your Mer user account and password (create account on https://bugs.merproject.org/)
Adaptations/libhybris/Install SailfishOS for hammerhead
|Product name:||Nexus 5|
|Sailfish OS version:||2.0.2|
|Device released|| Linux
Steps to install
- Install adb and fastboot on your workstation :
- Debian/Ubuntu: apt-get install android-tools-adb android-tools-fastboot
- Fedora: yum install android-tools
- Mageia: urpmi android-tools (included in upcoming relase of Mageia 5).
- OpenSUSE: zypper in android-tools
- Mac OS X: Install Homebrew from http://brew.sh/, then: brew install android-platform-tools
- Windows: See http://wiki.cyanogenmod.org/w/Doc:_fastboot_intro for instructions
- Download CyanogenMod 11 snapshot M11 from https://download.cyanogenmod.org/get/jenkins/86435/cm-11-20141008-SNAPSHOT-M11-hammerhead.zip and follow instructions from http://wiki.cyanogenmod.org/w/Install_CM_for_hammerhead to install the CyanogenMod image.
- Download Sailfish OS for Nexus 5 image from http://images.devaamo.fi/sfe/hammerhead/beta0/sailfishos-hammerhead-release-184.108.40.206-beta0-201510022255.zip and flash it over CyanogenMod.
- Reboot the device and it should boot to Sailfish OS. If the device shows Google logo for 4-5 minutes, do a reboot using power button.
- See below for MultiROM instructions
- If the CyanogenMod links do not work, use The Wayback Machine.
- If you are installing the beta 5 Nexus 5 image, rather than the beta0 one linked above, you will need to use a CyanogenMod 12.1 image rather than the CM11 one. A good, known working version is cm-12.1-20150901-SNAPSHOT-YOG4PAO237-hammerhead.zip.
- This page's instructions will otherwise work fine with the newer beta5 install.
WIP Over-the-Air updates (OTA)
- Open shell with normal nemo user
- You can be on any Sailfish OS version you have installed before
- Ensure that sailfish_latest_(architecture) repo on OBS points to the version you'll OTA to for best results (ping us on IRC if not sure)
Currently available OTA versions:
- for Nexus 4: 220.127.116.11
- for Nexus 5: 18.104.22.168, 22.214.171.124
- (we're also coding an OTA update checker, sync with mal- at IRC and help with that!)
RELEASE=<the version> # e.g. RELEASE=126.96.36.199 devel-su sed -i -e 's#^adaptation=.*$#adaptation=http://repo.merproject.org/obs/nemo:/testing:/hw:/lge:/hammerhead/sailfish_latest_armv7hl/#' \ /usr/share/ssu/repos.ini ssu dr adaptation0 ssu release $RELEASE ssu dr extra ssu dr mw ssu ar mw http://repo.merproject.org/obs/home:/RealJohnGalt:/testing:/common/sailfish_latest_armv7hl/ ssu er mw ssu ar dhd http://repo.merproject.org/obs/nemo:/testing:/hw:/lge:/hammerhead/sailfish_latest_armv7hl/ ssu lr # ^ double-triple check that no -two- enabled repos point to the same URL # You may have many of OpenRepos enabled. It's recommended to disable them, even # though version --dup will do its best-effort to isolate repositories: ssu lr | grep openrepos devel-su zypper clean -a devel-su zypper ref -f version --dup # if above fails, try again version --dup sync reboot
How to Build Image Yourself
- Refer to https://sailfishos.org/hadk and download the porting guide PDF from Step 1 in that link
- Automated Script - https://github.com/mer-hybris/build-script
For project status, bugs, and changelog click here.
devel-su pkcon refresh devel-su pkcon install SDL2 # hammerhead only: devel-su usermod -G net_bt_stack -a nemo
sync reboot # and enter recovery
Download appropriate .zip file:
- For CyanogenMod 10.1 base ROM: N/A
- For CyanogenMod 11.0 base ROM: https://www.dropbox.com/s/hwt3tjceomsfqbx/sfdroid-hammerhead.zip?dl=0
- Source code: https://github.com/krnlyng/sfdroid_renderer
It has been tested against SFOS 188.8.131.52, check for differences in init.rc for other versions before flashing (even though they should change rarely at this point).
- Install this zip via TWRP (used as example here) or CWM:
- MultiROM: via Advanced->Multirom->List Roms->your rom->Flash Zip
- Non-MultiROM: choose to Flash Zip or adb sideload (WARNING! If you ever use
fastboot boot boot.imgto boot to underlying CM, sfdroid will break that! To fix, you need to put back the original libsurfaceflinger.so)
- Reboot (might take longer than usual, screen might become unresponsive for a few seconds)
- Launch sfdroid from the App Grid
Play Android OpenGL Classic Games
devel-su zypper in apkenv
Find a game's APK on the Internet that matches _exact version_ from this list: http://wiki.maemo.org/Apkenv/Game_Compatibility
Once downloaded, perform in Terminal as normal user, e.g.:
You're welcome to help us by writing a small UI app that manages/launches those, or provides .desktop files.
Games tested on Nexus 5 successfully:
Amazing Alex Angry Birds Cut the Rope Fruit Ninja Petals Redux Plants vs. Zombies (no sound, WIP) Rabit Game 2 Super Hexagon World of Goo
To join the effort (or request a game), join #apkenv IRC channel on Freenode
Android Dalvik/Art apps are _not_ supported by apkenv.
Here as example we'll use hammerhead (Nexus 5) instructions. They are similar for other devices.
- MultiROM Installation instructions at http://forum.xda-developers.com/google-nexus-5/orig-development/mod-multirom-v24-t2571011
Refer to bugzilla for list of known issues.
OTA to 2.0.2 (unstable, for devs only)
- Enabled noise/echo cancellation during the call
Beta0 - 3 October 2015
- Sailfish OS UX v2.0 - more info, release notes
- OTA ready: see how
- Jolla Camera is back!
- Regression bug: video recording broken :( please help on bug here
- New app to showcase: CodeReader
Alpha13 - 10 September 2015
- Play classic Android OpenGL games from APK files (no apps only games)! Click here for instructions
- [not working reliably?] Android's virtual SD Card is now mounted on bootup, so all photos, videos, music are now visible in Sailfish OS apps
- MTP transfer mode works (not thoroughly tested), just choose "PC Connection" in Setting->System->USB
- CameraPlus icons are now bigger \o/
- New pre-installed apps: Books, Messwerk, Poor Maps, and SailorGram
- Sailfish OS 184.108.40.206
- WIP OTA only for those adventureous and who want to help polishing OTA: click here
Alpha12 - 19 June 2015
- Support for 5GHz WLAN APs
- Sailfish OS Update 15 (release notes)
- BUG: Jolla Store broken (server side), apologies but that's the burden we all have to bear until the Jolla Tablet comes out, in the meantime pls use Warehouse from Openrepos for apps (subscribe to bug for updates)
- FIXED in alpha13: Camera shows blackscreen when restoring the app. Can be worked around by restarting it (subscribe to bug for updates)
- BUG: Videos still have no sound, and app crashes on stop recording, but video is saved (subscribe to bug for updates)
Alpha11 - 29 April 2015
- Jolla Store hotfix
- New libhybris from upstream
- (tech bubbles:) Before Alpha10, porting underwent an important packaging reorg, which will make adaptation for future devices even easier and less cluttered
Alpha10 - 28 April 2015
- BROKEN Jolla Store. This slipped through the cracks, sorry, fixing in the next hotfix soon out
- Audio and video playback (MP3, MP4, H.264) works out-of-the-box using hardware accelerated codecs where applicable
- Bigger hi-res icons (to match the font)
- Sailfish OS early access Update 13 (release notes)
- BUG: inverted wallpaper scrolling. Fix by creating a custom ambience (click here for inspiration)
- BUG: WLAN may forget AP after first reboot. Please re-associate with your AP again, and then it will work normally thereafter
Alpha9 - 7 April 2015
- Camera! (Use cameraplus from app grid, native jolla-camera still needs love)
- Video playback including embedded HTML5 videos
Alpha8 - 28 February 2015
- All sensors!
- Sailfish OS public Update 11
Alpha7 - 27 February 2015
- Sailfish OS early access Update 11
Alpha6 - 29 January 2015
- hotfix for bug 785
Also available as OTA fix for alpha5 owners here.
Alpha5 - 14 January 2015
- WLAN remembers last connected AP after reboot - bug fixed
- Sailfish OS Update 10
- Fingerterm app scaled to the screen size
- Help us close this bug down - I could not reproduce it during 1st bootup
Alpha4 - 18 December
- Jolla Store enabled
- Sailfish OS Update 9
- Magnetometer support
- Improved BT HID support (US bt keyboard layout provided)
- Generic BT improvements
Alpha3 - 18 August
- Allow untrusted software
- Filemanager app
- USB connection dialogue: Developer mode, USB tethering, charging, ...
Alpha2 - 10 August
Alpha1 - 7 August
- Initial release