İçindekiler

SambaPOS Kodları nasıl güncellenir?

SambaPOS projesi üzerinde değişiklik yapabilmek için izin almanız gerekmiyor. Kodları dilediğiniz zaman indirip, üzerinde değişiklikler yapıp, yaptığınız değişiklikleri bize geri gönderebilirsiniz. SambaPOS kaynak kodları http://sambapos.googlecode.com sitesinde tutuluyor ve geliştirmeyi de bu sitenin sağladığı versiyon kontrol sistemini kullanarak yapıyoruz. Versiyon kontrol sistemleri birçok programcının aynı anda aynı proje üzerinde çalışmasını sağlayan sistemlerdir. Biz Mercurial adı verilen Versiyon Kontrol sistemini kullanıyoruz. Mercurial aynı proje üzerinde uzaktan birçok progamcının çalışabilmesini sağlıyor. Bu yazıda SambaPOS kodlarını nasıl alacağınızı, üzerinde nasıl değişiklik yapılacağını ve değiştirdiğiniz kodları nasıl geri yollayacağınızı göreceğiz.

Projeyi ilk kullanıma hazırlamak

Adım 1: TortoiseHg Kurulumu

Mercurial sistemine bağlanmanızı sağlayacak TortoiseHg Programını indirip kurun.

Adım 2: Kodları Alın

Bilgisayarınızda yeni bir dizin açın. Dizin içinde boş bir yere sağ tıklayın. TortoiseHg programının sağ tuş menünüze ekleme yaptığını göreceksiniz. Buradan “TortoiseHg > Clone…” menüsüne tıklayın.

Karşınıza dosyaları nereden almak istediğinizi soran bir ekran gelir. Buraya https://sambapos.googlecode.com/hg/ yazın.

Destination Path kısmınızda açtığınız dizini görüyor olmalısınız. Clone düğmesine tıkladığınızda program versiyon kontrol sistemimize bağlanıp SambaPOS projesini açtığınız dizine kopyalayacak.

Adım 3: Projeyi Visual Studio ile Açın

Kodların kopyalanması bittikten sonra herhangi bir proje gibi Visual Studio ile açıp dilediğiniz gibi kullanmaya başlayabilirsiniz.

Projeyi derleyebilmek için bilgisayarınızda .NET Framework 4.0 ve Entity Framework 4.1 kurulu olması gerektiğini unutmayın.

Geliştirme Yapmak

Bir iş seçin

Proje Sayfamızda Issues sekmesine tıkladığınız zaman ekibimizden gelen istekleri veya hata raporlarını göreceksiniz. Buradan yapmak istediğiniz bir iş seçebilirsiniz. Eğer mevcut işler dışında kendiniz birşeyler yapmak istiyorsanız öncelikle bununla ilgili bir Issue kaydı açın veya forumda fikrinizi dile getirin üzerinde konuşalım.

Status'u Proposed olan işler henüz bizim incelemediğimiz işlerdir. Bazı istekleri reddetmemiz söz konusu olabilir. Bu nedenle iş seçerken bizim onayladığımız yani durumu aktif olan ve kimseye atanmamış işlerden birini seçin ki zaten başka bir programcının yaptığı işin aynısını yapmak durumunda kalmayın.

Projeyi Klonlayın

Normalde proje üzerinde yaptığınız küçük değişiklikleri bize patch dosyaları şeklinde gönderebilirsiniz. Eğer daha kapsamlı bir çalışma yapmayı düşünüyorsanız o zaman projenin size ait bir klonunu oluşturabilirsiniz. Bunun için Source sekmesinde “Create Clone” düğmesine basmalısınız. Siz klon kodlar üzerinde istediğiniz değişiklikleri yaparsınız ve bu arada ana kodlar üzerinde diğer programcılar tarafından yapılan değişiklikler çalışmanızı etkilemez. Değişikliği tamamladıktan sonra bize haber verirsiniz ve biz yaptığınız değişiklikleri inceleyerek ana proje ile birleştiririz. Bir seferde çok fazla değişiklik gönderirseniz bizim kodları birleştirmemiz çok zor olacaktır. Bu nedenle yaptığınız her bir değişiklik veya eklediğiniz her bir özellik sonrasında kodu birleştirmemizi talep edin ve birleştirme tamamlandıktan sonra yeni bir klon oluşturup devam edin.

Source sekmesine gelip (Create Clone) dediğinizde size ait kopya oluşuturulacak. İlgili bilgileri doldurun. Klonu hangi işi yapmak için oluşturduğunuzu yazın. Bütün klonların kendine ait güncellme URL'leri vardır. İlk adımda yaptığınız gibi bilgisayarınızda yeni bir dizin açıp “Clone” komutu ile kodları yeniden indirin ancak bu sefer ana güncelleme URL'si yerine kendi klonunuza ait güncelleme URL'sini (Clone URL) kullanın. Dosyalar geldikten sonra projeyi Visual Studio ile açıp değişiklik yapmaya başlayabilirsiniz.

Değişikliği Geri Gönderin

İş bittikten sonra Proje dizini üzerinde sağ tıklayıp “HG Commit…” deyin ve gelen ekranda Commit düğmesine tıklayın. Böylelikle yaptığınız değişiklikleri bilgisayarınızdaki versiyon kontrol sistemine yansıtmış oldunuz. Değişiklikleri sunucuya göndermek için yine sağ tuş menüsünden “Hg Workbench” programını başlatın ve araç çubuğundan “Push” komutu verin. Toolbardaki düğmelerin üzerine geldiğinizde açıklamaları gelir. Tıklamanız gereken düğmenin “Push Outgoing Changes…” gibi bir açıklaması bulunmakta.

Değişikliğiniz tamamlandıktan sonra bizi haberdar etmek için bir “pull request” oluşturun. Gönderdiğiniz işle ilgili gelişmelerden mail yolu ile haberdar olacaksınız.