Quickstart-guide to start developing with Xamarin(.Forms)

FredyWengerFredyWenger CHInsider ✭✭✭✭✭
edited March 2015 in Xamarin.Forms

Hi all

I have created a description (.pdf) how to start work with Xamarin(.Forms) and Visual-Studio.
It contains a lot of information's for starters but also information's, like "how to use the forum", some tips and useful links
Table of content:

1 Prologue 3
2 To this document 3
3 My personal experience / opinion to Xamarin(.Forms) 4
4 The “Xamarin environment 6
4.1 Overview (greatly simplified) 6
4.1.1 Description 6
4.1.2 More details, some help… 9
4.1.2.1 … to the MAC-installation 9
4.1.2.2 … to TeamViewer 10
4.1.2.3 … to connect the (HW-)devices 11
4.1.2.4 … to the iOS-emulators 12
4.1.2.5 … to the Android-emulators 13
4.1.2.6 … to the Android-tools 15
4.1.2.7 … to NuGet 17
4.1.2.7.1 Add XLabs to project (VS2013 - Update 2) 17
4.1.2.7.1.1 Initial installation 17
4.1.2.7.1.2 Installing updates automatically 18
4.1.2.7.2 Installing specific versions over the NuGet-Console 19
5 Pre-requisites 22
5.1 Microsoft (Windows Phone) 22
5.2 Apple (iOS) 22
5.3 Google (Android) 22
6 Support / the Xamarin community 23
6.1 Support-Mailbox Xamarin 23
6.2 Support from Xamarin community 23
7 How to use the forum…? 24
7.1 Overview 24
7.2 Your account 25
7.3 Create a thread / post a message 27
7.4 Some other notes 33
7.5 “Like” what you like! 33
7.6 Searching for information’s 34
7.6.1 In the Forum 34
7.6.2 Over google (much better) 34
8 Submit a bug - how to use Bugzilla 38
9 Useful links 40
9.1 Documentation 40
9.1.1 e-book to Xamarin.forms (free) 40
9.1.2 Xamarin.Forms documentation 40
9.1.3 Good kick starter to Xamarin.Forms on the web 40
9.1.4 Get-started page from Xamarin 41
9.1.5 Xamarin Blog 41
9.2 Tools 42
9.2.1 Color-Picker 42
9.3 Add-in’s 42
9.3.1 XLabs (free) 42
9.3.2 Xamarin Component Store (partially free) 42
9.3.3 NuGet 43
9.4 Bugzilla 44
9.5 Xamarin “User voice” 44
10 Special tips for free  45
10.1 Work with your own public variables 45
10.2 Create your own user-controls! 45

Link: http://www.matrixguide.ch/Datenablage/diverses/Quickstart-Guide_Xamarin.pdf

Depending on the feedback I receive here in the thread, maybe I later update / enhance the document

:star:So.. if you are new to Xamarin, you SHOULD have a look...:star:

:smirk:And.. if not... maybe you will find some useful information's nevertheless..:smirk:

Posts

  • AlessandroCaliaroAlessandroCaliaro ITMember ✭✭✭✭✭

    well done @FredyWenger . You should join your work with xamarin kickstart guys...

  • JohnHardmanJohnHardman GBUniversity mod

    @FredyWenger - great work. I've forwarded it to a couple of former colleagues who are just about to start investigating Xamarin.Forms

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @AlessandroCaliaro, @JohnHardman ;

    Thanks for your (positive :smile:) feedback here...
    Allesandro:
    You are right...
    I have suggested the "owner" of the kickstart-guide, to post a link to my description, if he like it...

  • zipperlezipperle USUniversity ✭✭

    Well done @FredyWenger! Wow, huge respect to your efforts and contributions to the community!

    Maybe http://allaboutxamarin.com/ is worth to mention as a great resource for your useful links chapter.

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @ChristianFahrenholz:
    Thanks for your positive feedback.
    If I receive more positive comments / Likes to this thread, I will update/enhance the .pdf and then also include your suggested link under useful links.

  • imgenimgen CNBeta

    This tutorial is very good. Hope this comment counts as a positive feedback and be enough to make you update this guide

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @ImgenTata.5207:
    Thanks for your posting - and yes - it counts as positive feedback :smile:
    Any feedback here further pop this thread to the first page of the forum, so that also other users may take notice of it.
    :sunglasses: Note: You can find some further descriptions/documentations, if you click on my profile (avatar, name). :sunglasses:

  • BillMayBillMay USMember

    @FredyWenger Thanks for forwarding this link to me. Good stuff!

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    You're welcome :smile:

  • GeorgeCookGeorgeCook PEUniversity ✭✭✭

    awesome work - it's practically a book!

  • NMackayNMackay GBInsider, University mod

    @GeorgeCook

    I was saying that last week. It should be featured in the weekly newsletter and some test cloud hours should be sent to Fredy from Xamarin.

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    Pop (for the newbies)

  • ylemsoulylemsoul RUMember ✭✭✭

    @FredyWenger, great job :smile:
    In the Xamarin Forums Rules and Guidelines there is another trick described on how to paste a multiline-code without errors with indenting:

    To post source code that occupies multiple lines, use ``` followed by an empty line, your source code, and end with another empty line and ```. 
    
  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @ylemsoul:
    Thanks :smile:
    I think, exactly that is done (automatically in the background), if you make it over the editor like I have described in the documentation...
    But, I add id in my description (do it manually), if I do an update to my .pdf... :wink:

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @AlessandroCaliaro, JohnHardman, @ChristianFahrenholz, @ImgenTata.5207, @BillMay, @GeorgeCook, @NMackay, @ylemsoul:

    Just done a first update::smile:
    New and changed information's: bold in the table of content below and marked in the document (yellow = new, green = changed).
    @ylemsoul (I also have included a new example according your suggestion :smile:)

    New table of content (July 2015)

    1 Prologue 3
    2 To this document 3
    3 Version-History 4
    4 My personal experience / opinion to Xamarin(.Forms) 5
    5 The “Xamarin environment 8
    5.1 Overview (greatly simplified) 8
    5.1.1 Description 8
    5.1.2 More details, some help… 11
    5.1.2.1 … to the MAC-installation 11
    5.1.2.2 … to TeamViewer 12
    5.1.2.3 … to connect the (HW-)devices 13
    5.1.2.4 … to the iOS-emulators 14
    5.1.2.5 … to the Android-emulators 15
    5.1.2.6 … to the Android-tools 17
    5.1.2.7 … to NuGet 19
    5.1.2.7.1 Add XLabs to project (VS2013 - Update 2) 19
    5.1.2.7.1.1 Initial installation 19
    5.1.2.7.1.2 Installing updates automatically 20
    5.1.2.7.2 Installing specific versions over the NuGet-Console 21
    5.2 How to ship an (XF-) app to the (all) stores…? 24
    6 Pre-requisites 24
    6.1 Microsoft (Windows Phone) 24
    6.2 Apple (iOS) 24
    6.3 Google (Android) 24
    7 Support / the Xamarin community 25
    7.1 Support-Mailbox Xamarin 25
    7.2 Support from Xamarin community 25
    8 How to use the forum…? 26
    8.1 Overview 26
    8.2 Your account 27
    8.3 Create a thread / post a message 29
    8.3.1 Important general information’s 29
    8.3.1.1 Search, before you post…! 29
    8.3.1.2 How to access my draft’s…? 29
    8.3.1.3 “New Discussion” vs “Ask a Question” 30
    8.3.1.4 How to set notification…? 31
    8.3.1.5 How to bookmark (register / unregister to) a thread..? 31
    8.3.1.6 How to mark a message (“Like” / “Flag as Abuse”)..? 32
    8.3.2 Description how to post a message 33
    8.4 Some other notes 41
    8.5 “Like” what you like! 41
    8.6 Searching for information’s 42
    8.6.1 In the Forum 42
    8.6.2 Over google (much better) 42
    8.6.3 Special tip - how to re-find your own postings..? 46
    9 Submit a bug - how to use Bugzilla 47
    10 Useful links 49
    10.1 Documentation 49
    10.1.1 e-book to Xamarin.forms (free) 49
    10.1.2 Xamarin.Forms documentation 49
    10.1.3 Good kick starter to Xamarin.Forms on the web 49
    10.1.4 Other 49
    10.1.5 Get-started page from Xamarin 50
    10.1.6 Xamarin Blog 50
    10.2 Tools 51
    10.2.1 Color-Picker 51
    10.3 Add-in’s 51
    10.3.1 XLabs (free) 51
    10.3.2 Xamarin Component Store (partially free) 51
    10.3.3 NuGet 52
    10.4 Bugzilla 53
    10.5 Xamarin “User voice” 53
    11 Special tips for free  54
    11.1 Work with your own public variables 54
    11.2 Create your own user-controls! 54

    Cheers :sunglasses:

  • GeorgeCookGeorgeCook PEUniversity ✭✭✭

    The content looks good - I think you've put so much work into it, that you should go the extra mile and update your formatting. Make it consistent with better use of space. Most people will be expecting something spaced and sized more or less like a Wrox/Oreilly book. Perhaps go through a few of your favourite tech books for style, then go back and improve that aspect of it.

    I really love some of the tips you have in their for the forums and searching for information too. Most people don't think of that stuff, which is very important.

    My opinion is that you should make it look really gorgeous and put it on ibooks, or some other places. The content is good enough, certainly.

  • OtaMaresOtaMares DEMember ✭✭

    Putting it on github as a github page would make it more accessible and readable for people. Contribution would become a hell lot easier. And the credibility of this "guide" would drastically improve. Basically everything becomes better when using github.

  • SmathsSmaths USMember ✭✭

    This is amazing @FredyWenger! This is the kind of document I really wish existed when I got started and hopefully you will save other users many hours of frustration. I've saved a copy and am going to do a more thorough read through over the weekend to try to gather all the gems. Thanks so much for this work!

    Also, I agree with @Ota. Putting it on Github would make the guide a bit more accessible to users and will probably be easier to maintain over time. The pdf looks like it was a serious undertaking so no rush on that. (If you do decide to put it up on Github, I'd be willing to help move the content to try to save you from more work!––you've already done a ton)

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @GeorgeCook, @ota, @smaths

    First, thanks for your suggestions.
    I simply have created the document to help other users as I - like Eric wrote in his posting - also have searched a document of this kind (by my start to work with Xamarin) and… found nothing. Further, my native language is German (what you will have noted by have a look at the document :smirk: ) what cost me additional time…
    I make this for free and have not the intention to make money with it. If I wanted to sell it and make money with it - yes - I then would take the time to create a "stunning" layout. But I think, the content is readable and it’s better to post information’s in a bad (but hopefully understandable :smirk:) English and not optimal layout as posting no information’s :sunglasses:
    For me, the easiest way is, to create (and maybe update) the information’s in a word-document (as I also have our internal documentations in word) and then create a .pdf from and post a link.
    It’s also not my main-job to create app’s with Xamarin (I own a small IT-company and have created the app to solve a problem with our portal -> not servable with mobile-devices). This means, that I have to set the main-focus of my work to other themes now (as fortunately the app is in the stores now).
    Regarding "visibility", I have created a “community documentation thread” some times ago here:
    http://forums.xamarin.com/discussion/43458/the-community-documentation-thread#latest
    The Idea behind was, that it should contain a lot of community documentations and then - hopefully - would be pinned by Xamarin at the first page, so that every - especially new - developer is able to see it at the first page (every time).
    To post messages to the documentation's, until the "main-thread" once is pinned (and to pop the meta-thread to the first page after a new message is posted), this thread was thought:
    http://forums.xamarin.com/discussion/43560/meta-thread-to-the-community-documentation-thread#latest
    Unfortunately this seems not to work (only a few documentations added yet, almost no feedback from community).
    I think, the right place for documentations like mine is the XF-forum (as it's not a project with example-code and so on that should be enhanced from the community what most Github projects seems to be).
    But regarding Github, I nevertheless will send @Smaths a pm to check that option more in detail…

  • EdwinSEdwinS USMember ✭✭

    great

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    :wink:

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    pop

  • Geir-OveGeir-Ove NOMember ✭✭

    Incredible work and very helpful!

    I also run my own company, Objective Technology, and I am developing a Cross Platform (Windows & Xamarin.Forms) Tool to Conquer Code Complexity and Visually Debug Multi-Threaded Applications & Apps in ways I haven’t seen done before. I expect the tool to be released some-time in 2017.

    Through this tool you will be able to Visually see, in my Windows Tool, what is going on in your Single- or Multi-Threaded Xamarin App on your iPhone or Android device. Data is transferred over WiFi to the Windows Tool.
    _
    The most challenging part for me has been how to configure projects so that all this works on Windows, Android and iOS.
    I currently have it working on Windows & Android, but have to buy & configure iOS hardware to test it on iOS....

    Your guide is very helpful in this respect! Updates will be highly appreciated but you have already done a ton of work!

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @gos.8600
    Thanks for you comment :smile:

  • JohnHardmanJohnHardman GBUniversity mod

    @gos.8600 - If you need alpha/beta testers at any point, please let me know. Multi-threading is one of my areas of specialism. It would be good to combine more of that with the mobile development that I am now doing. My LinkedIn profile is at https://uk.linkedin.com/in/johnshardman

  • Geir-OveGeir-Ove NOMember ✭✭

    @JohnHardman
    I will keep you on my short-list: I will need someone to test!

    I am not disclosing the details of the system right now. More will be uncovered as soon as it is ok to do so.

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    pop

  • JulieMissonJulieMisson USMember

    Thankyou @FredyWenger I am a newbie and already I have found your documentation useful. I am sure I will be referring to it frequently.

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    pop

  • Khalid_S_YKhalid_S_Y USMember ✭✭

    Amazing! many useful ideas.......... lovely

  • voidstreamvoidstream FRMember ✭✭✭

    Why i didn't saw this before! Thanks guy!

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    @KhalidAlb, @voidstream
    You are welcome.

    Why i didn't saw this before! Thanks guy!

    As you can see, I "pop" the thread from time to time, so that it can be seen on top...
    And... you should like, what has helped you (see document) :sunglasses:

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    pop

  • FredyWengerFredyWenger CHInsider ✭✭✭✭✭

    pop

Sign In or Register to comment.