Skip to content

Commit

Permalink
[#56] Update to move data files to wiki (#57)
Browse files Browse the repository at this point in the history
* [#56] Update to move data to wiki

* Add missing packages

* Update README.md
  • Loading branch information
tekrei committed Jan 2, 2022
1 parent 38af71e commit d825edd
Show file tree
Hide file tree
Showing 16 changed files with 1,074 additions and 1,392 deletions.
21 changes: 0 additions & 21 deletions .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,27 +31,6 @@ jobs:
with:
files: subadapmuzik-${{ steps.currenttag.outputs.tag }}.apk
tag_name: ${{ steps.currenttag.outputs.tag }}
# build-android-remote:
# name: Build Android Remotely
# runs-on: ubuntu-latest
# steps:
# - uses: actions/checkout@v2
# - uses: actions/setup-node@v2
# with:
# node-version: "lts/*"
# - uses: expo/expo-github-action@v6
# with:
# expo-version: 4.x
# token: ${{ secrets.EXPO_TOKEN }}
# - name: Install dependencies
# run: yarn install
# - name: Build packages
# run: (yarn build:android | grep https://expo.dev/artifacts/eas/) > apk_url.txt
# - name: APK URL
# uses: actions/upload-artifact@v2
# with:
# name: apk_url
# path: apk_url.txt
publish:
name: Publish
runs-on: ubuntu-latest
Expand Down
96 changes: 73 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,44 +4,75 @@
[![Runs with Expo Go](https://img.shields.io/badge/Runs%20with%20Expo%20Go-000.svg?logo=EXPO&labelColor=3b444c&logoColor=white&color=32ca55)](https://expo.dev/@kinefi/subadap-player)
[![Licensed by Apache](https://img.shields.io/badge/License-Apache%202.0-success.svg?labelColor=3b444c&logoColor=white&color=32ca55)](https://github.com/kinefi/subadap-player/blob/develop/LICENSE)

[Şubadap Müzik Çalar](https://github.com/kinefi/subadap-player), [Kinefi](https://github.com/kinefi) tarafından özgür yazılım olarak geliştirilen ve [Apache Lisansı 2.0](https://github.com/kinefi/subadap-player/blob/develop/LICENSE) kapsamında yayınlanan bir uygulamadır.
[Şubadap Müzik Çalar](https://github.com/kinefi/subadap-player),
[Kinefi](https://github.com/kinefi) tarafından özgür yazılım olarak geliştirilen
ve
[Apache Lisansı 2.0](https://github.com/kinefi/subadap-player/blob/develop/LICENSE)
kapsamında yayınlanan bir uygulamadır.

Sürümler ve değişiklikler için [değişiklik günlüğüne](./CHANGELOG.md) bakabilirsiniz.
Sürümler ve değişiklikler için [değişiklik günlüğüne](./CHANGELOG.md)
bakabilirsiniz.

## Geliştirme

[Expo](https://expo.dev/) kullanılarak geliştirilen bir [React Native](https://reactnative.dev/) uygulamasıdır.
[Expo](https://expo.dev/) kullanılarak geliştirilen bir
[React Native](https://reactnative.dev/) uygulamasıdır.

Geliştirme ortamı olarak [Expo](https://expo.dev/)'yu kurmak için [Introduction to Expo](https://docs.expo.dev/) sayfasına bakılabilir. Komut satırı işlemleri için [expo-cli](https://docs.expo.dev/workflow/expo-cli/) ve paket yöneticisi olarak da [yarn](https://yarnpkg.com/) tercih edilmiştir.
Geliştirme ortamı olarak [Expo](https://expo.dev/)'yu kurmak için
[Introduction to Expo](https://docs.expo.dev/) sayfasına bakılabilir. Komut
satırı işlemleri için [expo-cli](https://docs.expo.dev/workflow/expo-cli/) ve
paket yöneticisi olarak da [yarn](https://yarnpkg.com/) tercih edilmiştir.

Özetle aşağıdaki uygulamaları sırayla kurmak gerekiyor:

- [node](https://nodejs.org/en/download/) (kurmak için [NVM](https://github.com/nvm-sh/nvm) de kullanabilirsiniz)
- [yarn](https://classic.yarnpkg.com/en/docs/install): `npm install --global yarn`
- [expo-cli](https://docs.expo.dev/workflow/expo-cli/): `npm install -g expo-cli`
- [node](https://nodejs.org/en/download/) (kurmak için
[NVM](https://github.com/nvm-sh/nvm) de kullanabilirsiniz)
- [yarn](https://classic.yarnpkg.com/en/docs/install):
`npm install --global yarn`
- [expo-cli](https://docs.expo.dev/workflow/expo-cli/):
`npm install -g expo-cli` (bu aracı kurmanız zorunlu değil, sonraki adımda
geliştirme bağımlılığı olarak kurulacaktır)

Ortam hazır olduktan sonra aşağıdaki betikleri projenin olduğu dizinde kullanabilirsiniz:
Ortam hazır olduktan sonra aşağıdaki betikleri projenin olduğu dizinde
kullanabilirsiniz:

- `yarn install`: Gerekli paketleri kurar, sadece `yarn` olarak da kullanabilirsiniz.
- `yarn install`: Gerekli paketleri kurar, sadece `yarn` olarak da
kullanabilirsiniz.
- `yarn start`: Expo sunucusunu başlatır.
- `yarn android`: Android emülatörünü başlatır, bunu ayrı bir terminalde başlatmanız gerekiyor.
- `yarn ios`: IOS emülatörünü başlatır, bunu ayrı bir terminalde başlatmanız gerekiyor.
- `yarn android`: Android emülatörünü başlatır, bunu ayrı bir terminalde
başlatmanız gerekiyor.
- `yarn ios`: IOS emülatörünü başlatır, bunu ayrı bir terminalde başlatmanız
gerekiyor.
- `yarn web`: Tarayıcıda görüntülemek için.
- `expo publish`: Mevcut sürümü [Expo projesine](https://expo.dev/@kinefi/subadap-player) gönderir.
- `expo build:android`: Android paketi oluşturur.
- `expo publish`: Mevcut sürümü
[Expo projesine](https://expo.dev/@kinefi/subadap-player) gönderir.
- `expo build:android`: Android paketi oluşturur. APK dosyasını yerelde kaydetmesi için `--local` argümanıyla çalıştırın.
- `expo build:ios`: IOS paket oluşturur.
- `yarn add <paket adı>`: Yeni bir paket/kütüphane eklemek için, belli bir pakete ihtiyacınız varsa <https://www.npmjs.com/> sayfasında arayabilirsiniz.
- `yarn add <paket adı>`: Yeni bir paket/kütüphane eklemek için, belli bir
pakete ihtiyacınız varsa <https://www.npmjs.com/> sayfasında arayabilirsiniz.

Tüm [albümler](./data/albums.json) ve [şarkılar](./data/songs.json) JSON olarak saklanıyor. Kolayca güncelleme ve JSON dosyalarını oluşturmak için [data/songs.xlsx](./data/songs.xlsx) dosyasından yararlanılabilir.
Tüm
[albümler](<[./data/albums.json](https://ansiklopedi.subadapcocuk.org/albums.json)>)
ve
[şarkılar](<[./data/songs.json](https://ansiklopedi.subadapcocuk.org/songs.json)>)
JSON olarak saklanıyor. Kolayca güncelleme ve JSON dosyalarını oluşturmak için
[data/songs.xlsx](./data/songs.xlsx) dosyasından yararlanılabilir.

### Kullanılan Önemli Kütüphaneler

- [FontAwesome](https://github.com/FortAwesome/react-native-fontawesome) tarafından sunulan ücretsiz simgeler kullanılıyor
- [Expo AV](https://docs.expo.dev/versions/latest/sdk/av/) ortam dosyaları için kullanılıyor
- [FontAwesome](https://github.com/FortAwesome/react-native-fontawesome)
tarafından sunulan ücretsiz simgeler kullanılıyor
- [Expo AV](https://docs.expo.dev/versions/latest/sdk/av/) ortam dosyaları için
kullanılıyor

## Yayınlama ve test etme

Ana (`main`) dala gönderilen/itilen kod olması durumunda [`publish` görevi](.github/workflows/main.yml#L7) otomatik olarak çalışıyor ve Expo'ya [denenmeye hazır son sürümü](https://expo.io/@kinefi/subadap-player) itiyor. Bu yayınlama görevi Expo tarafından sunulan [örnek akışlardan](https://github.com/expo/expo-github-action#example-workflows) yararlanılarak eklendi.
Ana (`main`) dala gönderilen/itilen kod olması durumunda
[`publish` görevi](.github/workflows/main.yml#L34) otomatik olarak çalışıyor ve
Expo'ya [denenmeye hazır son sürümü](https://expo.io/@kinefi/subadap-player)
itiyor. Bu yayınlama görevi Expo tarafından sunulan
[örnek akışlardan](https://github.com/expo/expo-github-action#example-workflows)
yararlanılarak eklendi. APK dosyası da [`build-android` göreviyle](.github/workflows/main.yml#L8) otomatik olarak oluşturulup bir sürüm yayınlanıyor.

Sürüm değiştirmek için:

Expand All @@ -57,12 +88,31 @@ yarn
yarn start
```

⚠️ Bu komutların çalışması için yukarıda bağlantıları verilen `node`, `yarn` ve `expo-cli` araçlarının kurulu olması gerekiyor.
⚠️ Bu komutların çalışması için yukarıda bağlantıları verilen `node`, `yarn` ve
`expo-cli` araçlarının kurulu olması gerekiyor.

Komut satırındaki yönergelere uyulabilir veya açılacak pencereden telefonda karekod okutularak uygulama denenebilir.
Komut satırındaki yönergelere uyulabilir veya açılacak pencereden telefonda
karekod okutularak uygulama denenebilir.

## Şubadap Çocuk

[Şubadap Çocuk](https://subadapcocuk.org), çocuk şarkıları yapan bir müzik grubudur. 2013 yılında İzmir'de kurulmuştur. Çocukların, kendi hayatlarına değen, onların karşılaştıkları durumları/çelişkileri konu alan ve içinde yaşadıkları dünyaya dair kendi sözlerini söylemesini hedefleyen tematik şarkılar yapmaktadır. Bugüne kadar yayınlanmış 6 albümü ve toplam 40 şarkısı bulunmaktadır. Yalnızca kendi şarkılarını seslendirdiği çocuk şarkıları konserleriyle Türkiye, Kıbrıs, Almanya ve Hollanda'nın çeşitli yerlerinde bugüne dek 500'ün üzerinde yerde çocuklarla buluşmuştur. Konserleri yalnızca kentlerde değil, Türkiye'nin birçok bölgesindeki köy okullarında, mahallelerde, parklarda da vermiştir. Sahnede genellikle davul (bateri), bas gitar, gitar, flüt, keman, akordiyon, trompet ve mandolin çalgılarıyla yer almaktadır.

Uygulamada kullanılan ve bağlantı verilen tüm şarkılar, resimler, sayfalar, kitaplar, vb. [Şubadap Çocuk Ansiklopedisi](http://ansiklopedi.subadapcocuk.org/index.php/%C5%9Eubadap_%C3%87ocuk_Ansiklopedisi)ndedir. [Şubadap Çocuk](https://subadapcocuk.org) yaptığı tüm üretimleri [Copyleft](http://ansiklopedi.subadapcocuk.org/index.php/Copyleft) kapsamında yayınlamaktadır. Şarkılar doğrudan uygulamada yer almıyor, İnternet üzerinden akış şeklinde çalıyor. Dolayısıyla uygulamayı kullanabilmek için İnternet bağlantısı gerekmektedir.
[Şubadap Çocuk](https://subadapcocuk.org), çocuk şarkıları yapan bir müzik
grubudur. 2013 yılında İzmir'de kurulmuştur. Çocukların, kendi hayatlarına
değen, onların karşılaştıkları durumları/çelişkileri konu alan ve içinde
yaşadıkları dünyaya dair kendi sözlerini söylemesini hedefleyen tematik şarkılar
yapmaktadır. Bugüne kadar yayınlanmış 6 albümü ve toplam 40 şarkısı
bulunmaktadır. Yalnızca kendi şarkılarını seslendirdiği çocuk şarkıları
konserleriyle Türkiye, Kıbrıs, Almanya ve Hollanda'nın çeşitli yerlerinde bugüne
dek 500'ün üzerinde yerde çocuklarla buluşmuştur. Konserleri yalnızca kentlerde
değil, Türkiye'nin birçok bölgesindeki köy okullarında, mahallelerde, parklarda
da vermiştir. Sahnede genellikle davul (bateri), bas gitar, gitar, flüt, keman,
akordiyon, trompet ve mandolin çalgılarıyla yer almaktadır.

Uygulamada kullanılan ve bağlantı verilen tüm şarkılar, resimler, sayfalar,
kitaplar, vb.
[Şubadap Çocuk Ansiklopedisi](http://ansiklopedi.subadapcocuk.org/index.php/%C5%9Eubadap_%C3%87ocuk_Ansiklopedisi)ndedir.
[Şubadap Çocuk](https://subadapcocuk.org) yaptığı tüm üretimleri
[Copyleft](http://ansiklopedi.subadapcocuk.org/index.php/Copyleft) kapsamında
yayınlamaktadır. Şarkılar doğrudan uygulamada yer almıyor, İnternet üzerinden
akış şeklinde çalıyor. Dolayısıyla uygulamayı kullanabilmek için İnternet
bağlantısı gerekmektedir.
44 changes: 0 additions & 44 deletions data/albums.json

This file was deleted.

Loading

0 comments on commit d825edd

Please sign in to comment.