FAQ
-
Getting started
- Why use the Projects site?
- What functionality does Projects offer?
- How can I find interesting projects?
- I like the project, where can I get the software?
- How do I join a project?
- What do I need to know to create a project
- How do I make my project successful
- Where is the rest of the documentation?
- How do I get HELP?
- Tracking Project Changes
- Browsing and downloading sources
- Sharing non-source files
- Release management
- Known Issues
Getting started
Nokia Developer Projects provides a very intuitive interface for both project users and owners. There are on screen explanations for most functionality (where it isn't obvious) and the project default settings are suitable for the vast majority of new projects. It is not unreasonable that you'll jump in at Projects Home and we won't see you here again for some time.
The topics below are for those who want an even gentler introduction.
Why use the Projects site?
Nokia Developer Projects is the online hosting solution for collaborative software development in mobile. If you have a idea for a project that you'd like to explore and grow, then we have an active and vibrant global community of like-minded developers who can help you, and a powerful set of project and source management tools that you can use to engage and collaborate with them.
We've got a lot more information on this topic in Why use Projects.
What functionality does Projects offer?
Projects offers all the important tools needed to host and grow a software development project within a single integrated (and project centric) environment. The tools include a version control system repository for your code, a wiki for your documentation, discussion and announcement boards for communicating with your users and development team, a ticketing system for tracking tasks (integrated with a roadmap timeline for tracking development milestones), a Files section for sharing general files, and a Summary page which you can use to introduce users to your project, which displays your latest Featured Downloads (releases).
Projects offers excellent tools to discover new and interesting projects, and to follow all (or specific) changes within projects of interest. That said, you have complete control over what is shared with your project team and the wider world through a fine grained permission system.
Why use Projects covers these benefits in more detail.
How can I find interesting projects?
Project Explorer helps you find projects of interest, based on category and search keyword, and also activity and age. Once you've found a project of interest you can browse to its Summary page to find out more.
We have more information on Project Explorer here.
I like the project, where can I get the software?
The project owner may make software releases available as "Featured Downloads" on the project Summary page (using the Downloads System).
However you should check the particular project Summary page and Wiki documentation. Some projects may distribute their software using Ovi, others may use the Files section, others may just supply the source and require you to build it yourself.
How do I join a project?
A public project is by default configured to make it easy for you to join. Just click the Request to join button on the Summary page (below the project team listing) then enter some information about why you would like to join the project in the next dialog. A message will be sent to the project owner, who can add you as a project member. If you're already a project member then the button changes to Request more rights
You can also be invited to join a private project, in which case the project owner will tell you what you need to do!
What do I need to know to create a project
Creating a project is straightforward, as covered in the topic Creating a project. However if you want to be successful, we highly recommend you first read Why use Projects and the other documents in WikiStart (in order). Pay particular attention to Growing a successful project
How do I make my project successful
We provide some ideas for better engaging with developers in Growing a successful project. In general these explain how to make your project more visible and vibrant, as these are preconditions for getting other developers to want to help you!
Where is the rest of the documentation?
We provide links to key documentation from the WikiStart page (and from this FAQ); these in turn link to other useful documents, where relevant.
Should you want to browse the whole document set, please see the TitleIndex.
How do I get HELP?
If you still have a problem after reading this Guide, your first port of call is to ask us for help on the Community Help and Support discussion board. If the problem is a defect or requires and enhancement we'll raise a Ticket so you can track progress on a fix.
We can help with problems related to Projects, Wiki, Blogs and Discussion boards.
We also welcome your suggestions feedback, which can be provided through the same channels (Yes, really! Community feedback has made a significant different to the services we offer).
Tracking Project Changes
Project tracking and tracking configuration options are discussed in detail in ProjectsTrackingChanges.
How do I find all project changes
To get notification of all changes to a project you can Follow it for email notification, or get an RSS Feed from the Timeline tab. You can also view the Timeline tab if you prefer to browse rather than be notified of changes. All these options are covered in ProjectsTrackingChanges.
How do I track just changes in Tickets?
If you create a ticket you'll be notified of all changes to that ticket. If you're a project member you can add yourself to the email CC list of any ticket. Whether or not you're not a member you can get an RSS feed for specific tickets, or to be notified of all new tickets. These options are covered in ProjectsTrackingChanges.
How do I track just changes in discussions?
Logged in users can "Subscribe" for email notification of changes to whole discussion boards or to individual posts. Any user (logged in or otherwise) can get RSS feeds for these too. These options are covered in ProjectsTrackingChanges.
How do I track just changes in wiki, featured downloads?
There are no specific subscriptions or RSS feeds for wiki or downloads. You can however specify a filter on the Timeline tab to generate a feed for any part of the site.
Browsing and downloading sources
How can I browse the source of a project?
Select the "Source" tab on your project. This provides a Web interface to browse sources, review changes and commit messages, and to download individual files. You can also download the source from the repository (if you have the default permissions) and browse it locally, as discussed in following sections.
Can I download a file from the source browser?
Yes. Click the Original file link at the bottom of any Source tab file page in order to save it locally.
How can I get all the project sources?
Project members will typically use a version control system to access the project repository, integrating this with their IDE or preferred build system as required. Refer to your software vendor's site for information on how to do this (additionally we have provided links to some useful version control tools and IDEs in ProjectsToolsUsefulToolsAndIDEs).
The project may also make source code releases available to users or project members for download (usually in a zip file). We would recommend that the project uses the Files Section for this purpose, or possibly the Downloads System
Git gives me an SSL error
Please see ProjectsToolsGitQuickStart#GitTLSissue
When checking out a get an SSL error
SSL handshake failed: SSL alert received: Error in protocol version ( https://projects.forum.nokia.com)
This is a problem of all clients compiled with GNUTLS. You can see how to use openSSL here
SSL negotiation failed: SSL disabled due to library version mismatch ( https://projects.forum.nokia.com)
You might have to rebuild a few libraries. This issue was found for example in kubuntu 10.4, but not in ubuntu 10.4. See topic 13 in our forums.
TortoiseGit gives me a strange error
You most likely have not installed msysgit or not configured it properly, check out ProjectsToolsGitQuickStart#TortoiseGit.
Sharing non-source files
You can share and store files with your team using the Files section. This is primarily intended for files that aren't under source control and which aren't particularly relevant to end-users.
What is WebDAV
Web-based Distributed Authoring and Versioning (WebDAV) is a set of methods based on the Hypertext Transfer Protocol (HTTP) that allow you to work with and manage files and documents stored on the Internet (see http://en.wikipedia.org/wiki/WebDAV for more information).
You can use WebDAV to access files stored in your Nokia Developer Project, either through the browser or through a WebDAV client. See Files section for more information, including links through to WebDAV clients for common operating systems.
How do I use BitKinex? WebDAV client
See ProjectsToolsWebDavBitKinexQuickStart.
How do I use Cyberduck WebDAV client
See ProjectsToolsWebDavCyberduckQuickStart.
Release management
How should I package up a release?
We recommend that you use a format that makes sense to your end-users, and that you require them to download as few files as possible (i.e. one) to get the release. It is also important to provide clear and simple instructions on how to download and use your package.
If your project creates a mobile phone application, then your release will usually be an installation file for your target system (for example a Symbian .SIS file). However if your project delivers a collection of documents, web pages, images or other files then you would probably encapsulate these in a single zip file for download.
Where should I put my releases?
We recommend you use the downloads system; this displays your current (Featured) downloads on the summary page and makes older releases available from your wiki. If your project creates an application on Ovi, you might instead link to its Ovi download page from your project's Summary.
It is also possible to use the Files Section, but this is primarily intended for sharing files with your project team, and is less obvious to end users.
Known Issues
GNU TLS issues
Most linux distributions have git, svn, hg and davfs compiled with gnutls. However gnutls has a bug and therefore you may get "Wrong protocol version" or similar when using some of these tools. In this case you need to build your tools to work with openssl.
Building git
Build normally but with configure use --with-openssl --with-expat and --with-curl configuration options to make sure that git uses openssl and works with https scheme and dav.
Building svn
Build normally but with configure use --with-ssl. Here are some simple steps to install it on your home.
Go first to some install directory where you keep sources wget http://subversion.tigris.org/downloads/subversion-1.6.11.tar.bz2 wget http://subversion.tigris.org/downloads/subversion-deps-1.6.11.tar.bz2 tar -xjvf subversion-1.6.11.tar.bz2 tar -xjvf subversion-deps-1.6.11.tar.bz2 cd subversion-1.6.11 ./configure --with-ssl --prefix=$HOME make make install
See that you are using correct svn (usually it's correct)
which svn
This should output /home/[your username]/bin/svn
If not, add to your .bashrc or .profile
if [ -d "$HOME/bin" ] ; then
PATH="$HOME/bin:$PATH"
fi
Attachments
-
NokiaProjectsFAQJoinRequest.png
(5.0 KB) -
added by hamishwillee 6 months ago.
Image of the button to join a project
