README.md 6.74 KB
Newer Older
1
# Oyun Parkı Nedir?
Eda Altuntaş's avatar
Eda Altuntaş committed
2

3
​	Oyun Parkı `Pardus` kurulumunuzu etkilemeden yüklemeler yapabileceğiniz bir `Oyun Parkı`dır. Docker konteyner yapısını kullanarak Pardus `xfce` masaüstü ortamına sahip bilgisayarınızdan bağımsız bir park *(konteyner)* oluşturur. Bu oluşturulan parkı arayüz üzerinden ister `grafik arabirime` ister `terminal ortamına` tek tıkla bağlanarak anında kullanmaya başlayabilirsiniz.
Eda Altuntaş's avatar
Eda Altuntaş committed
4

5
### Pardus Dağıtımına Katkıları Nedir?
Eda Altuntaş's avatar
Eda Altuntaş committed
6

7 8
------

9
​	Oyun Parkı Pardus kullanıcılarının kendi yüklemelerine zarar vermeden Pardusun özgür ve yenilikçi dünyasını diledikleri gibi keşfetmelerine yardımcı olur.
10

11 12 13 14 15 16 17
### Sunuma ve Demo Videosuna Nereden Ulaşılır?

------

​	Repositorye dahil olan [OyunParkı_Nyx-Sunum.pdf](https://kod.pardus.org.tr/nyx/oyun-parki-ui/blob/main/OyunParkı_Nyx-Sunum.pdf) dosyasını indirerek sunumumuzu inceleyebilir, [Oyun Parkı Demo](https://youtu.be/0JF3dY0rKh8) adresinden videoyu izleyerek fikirlerinizi bizimle paylaşabilirsiniz.

### Oyun Parkı Hangi Parçalardan Oluşur?
18 19 20

------

21 22 23
- Oyun Parkının arayüz ve dolayısıyla ana projesinin kaynak kodlarına [Oyun Parkı](https://kod.pardus.org.tr/nyx/oyun-parki-ui) repositorysinden ulaşabilirsiniz.
- Oyun Parkının Pardus ondokuz xfce imajlarının kaynak kodlarına [Oyun Parkı Imaj](https://kod.pardus.org.tr/nyx/oyun-parki-imaj) repositorysinden ulaşabilirsiniz.
- Oyun Parkının Docker servisi ile iletişime geçmesini sağlayan API kaynak kodlarına [Oyun Parkı API](https://kod.pardus.org.tr/nyx/oyun-parki-api) repositorysinden ulaşabilirsiniz.
24

25
### Nasıl Kurulur?
26 27 28

------

29
​	Bu repodaki kurulum aşamalarını incelemeden önce [Oyun Parkı Imaj](https://kod.pardus.org.tr/nyx/oyun-parki-imaj) reposundaki kurulum adımlarını takip etmeniz kurulum aşamalarını kısaltacaktır. Ardından aşağıdaki iki farklı kurulum şeklini inceleyerek sizin için en uygun kurulum metodunu seçerek kolayca kurabilirsiniz.
30

31
#### Deb Paketine Nasıl Erişebilir?
32 33 34

------

35
​	Repositorye dahil olan `oyun-parki_0.1.0_amd64.deb` dosyasını indirebilir veya [http://bit.ly/oyunparki-deb](http://bit.ly/oyunparki-deb) linkinden ulaşabilirsiniz.
36

37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
------

#### Deb Paketi ile Nasıl Kurulur?

------

1. Hazırlanmış olan deb paketini bilgisayarımıza indiriyoruz.

   ```bash
   wget https://kod.pardus.org.tr/nyx/oyun-parki-ui/raw/main/oyun-parki_0.1.0_amd64.deb
   ```

2. İndirdiğimiz deb paketini bilgisayarımıza kuruyoruz.

   ```bash
   sudo apt-get install ./oyun-parki_0.1.0_amd64.deb
   ```

Oyun Parkını kurmak bu kadar kolay 😎. Kurulum sonrası adımlarını izleyerek pürüzsüz bir Oyun Parkı deneyimi yaşayabilirsiniz. 

#### Kurulumdan Sonra Ne Yapılmalı?
Eda Altuntaş's avatar
Eda Altuntaş committed
58

59 60
------

61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93
1. Oyun Parkını açmadan önce Docker servisinin çalıştığına ve varsayılan kullanıcı için erişebilir olduğuna aşağıdaki komut ile emin oluyoruz.

   ```bash
   docker info
   ```

   Eğer yukarıdaki aşamada docker servisinin bilgileri yerine `permission denied` hatası alırsak aşağıdaki komutları uygulamamız gerekiyor.

   1. Sistemimizde `docker` isimli bir grup oluşturuyoruz.

      ```bash
      sudo groupadd docker
      ```

   2. Varsayılan kullanıcımızı `docker` grubuna ekliyoruz.

      ```bash
      sudo usermod -aG docker $USER
      ```

   3. Yaptığımız ayarların kayıt olduğuna emin olmak için Uç birim terminalimizi açıp kapattıktan 1. adımdaki `docker info`  komutunun çıktısında tekrar `permission denied` hatası alırsak bilgisayarımızı yeniden başlatmalıyız. 

#### Yukarıdaki Adımları Uygulandı, Nasıl Çalıştırılır?

------

​	Yukarıdaki adımları tamamlayıp Docker servisinin sorunsuz çalıştığına emin olduktan sonra başlat menüsü üzerinden veya `oyun-parki` komutu ile Oyun Parkı ile Pardusun özgür ve yenilikçi dünyasını keşfetmeye başlayabiliriz! 🥳

#### Kaynak Kodunu Derleyerek Nasıl Kurulur?

------

​	Oyun Parkının kaynak kodlarını kullanarak kendi bilgisayarınızda derlemek isterseniz öncelikle `git` aracının yüklü olduğundan, ardından `nodejs` paketinin 16.x sürümünde olmasına dikkat etmelisiniz. Bu paketler hali hazırda bulunuyor ise 5. adıma atlayabilirsiniz.
94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145

1. İlk aşağıdaki komutu kullanarak nodesource repolarını apt kaynak listesine ekliyoruz.

   ```bash
   echo "deb https://deb.nodesource.com/node_16.x buster main" | sudo tee /etc/apt/sources.list.d/nodesource.list
   ```

2. Kaynak listesine ekledikten sonra apt kaynağının gpg anahtarını bilgisayarımıza ekliyoruz.

   ```bash
   curl -fsSL https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo apt-key add -
   ```

3. GPG anahtarını ekledikten ettikten sonra apt paketlerimizi güncelliyoruz.

   ```bash
   sudo apt-get update
   ```

4. Paketlerin güncelleme işlemi bittiğinde aşağıdaki kod ile son sürüm nodejs paketimizi kuruyoruz.

   ```bash
   sudo apt-get install nodejs
   ```

5. Nodejs paketimizi başarıyla kurduktan sonra `git` aracını kullanarak projemizi indiriyoruz ve gerekli npm paketlerini yüklüyoruz.

   ```bash
   git clone https://kod.pardus.org.tr/nyx/oyun-parki-ui
   cd oyun-parki-ui && npm install
   ```

6. Projemize API paketini dahil etmek için src klasörüne giriyor ardından git aracı ile indiriyoruz. İndirdikten sonra gerekli npm paketlerini yüklüyoruz.

   ```bash
   cd src
   git clone https://kod.pardus.org.tr/nyx/oyun-parki-api
   cd oyun-parki-api && npm install
   ```

7. Paketlerimizi yükledikten sonra projenin ana dizinine dönüyor ve electron ile kurulum aşamasına geçiyoruz.

   ```bash
   cd ../../ && npm run electron:build
   ```

8. Başarıyla tamamlandığında deb paketini kullanarak Oyun Parkını bilgisayarımıza kuruyoruz.

   ```bash
   sudo apt-get install -y ./dist_electron/oyun-parki_0.1.0_amd64.deb
   ```

146
### Peki, Yol Haritasında Neler Var?
147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164

------

​	Oyun Parkı [Açık Kaynak Hackathon Programı](https://www.acikhack.com/) için 3-7 Mayıs 2021 tarihleri arasında kısıtlı bir zamanda geliştirilmiş bir projedir. Bu sebeple düşünülen çoğu özellik eklenememiştir. Müsait olduğumuz zamanlarda aşağıdaki yol haritasına uyarak geliştirilmeye devam edilecektir.

- [x] Pardus `XFCE` masaüstü Imajı
- [x] Gerçek bir Pardus deneyimi süren `XFCE` masaüstü Imajı

- [x] Docker Desteği
- [x] Express.js + Dockerode
- [x] Vue + Electron
- [x] Paylaşımlı pano
- [x] Parklar ile ana bilgisayar arasında dosya paylaşımı

- [ ] Podman Desteği *(Pardus dağıtımının yirmibir versiyonun çıkması ve podman desteğinin resmi olarak gelmesi beklenmektedir.)*
- [ ] Yüksek FPS ve kaliteli ses aktarımı *(Podman Desteği beklenmektedir.)*

- [ ] Özelleştirilmiş Spice Istemcisi *(Spice-gtk paketini forklayarak daha fazla özelliğe ev sahibi olması amaçlanmaktadır.)*
Eda Altuntaş's avatar
Eda Altuntaş committed
165