Kurulum

Çerçeve kurulumu için Node.js paketi bilgisayarınızda kurulu olmalıdır.

Gereksinimler

Sadece Node.js 18.15.0 ve üzeri sürümler desteklenir, çalışma ortamınıza Nvm ile Node.js'i yüklemek için aşağıdaki makaleye gözatın.

Bir Olobase önyüz projesi yaratmak için aşağıdaki adımları izleyin.

git clone --branch 1.3.1 [email protected]:olomadev/olobase-skeleton-ui myproject

Projenizin kök klasörüne gidin

cd /var/www/myproject

olobase-admin alt modülünü etkinleştirin

git submodule update --init

Npm ile node modüllerini yükleyin.

npm i

Kök dizindeki env.dist dosyasını env.dev olarak kaydedin.

VITE_DEFAULT_LOCALE=en
VITE_FALLBACK_LOCALE=en
VITE_SUPPORTED_LOCALES=en,tr
VITE_API_URL=http://example.local/api
VITE_HCAPTCHA_SITE_KEY=
VITE_LICENSE_KEY=
VITE_SESSION_UPDATE_TIME=5
VITE_COOKIE={ "token": "_token", "user": "_user" }

Vite.config.js

Vit yapılandırmasının server.host adres değeri varsayılan olarak her zaman 0.0.0.0 olarak kalmalıdır. Bu değer, yerel veya VMWare gibi sanal bir sunucuyla çalışıyor olsanız bile, sunucunun tüm ana bilgisayar adreslerini dinlemeye açık olduğu anlamına gelir. Böylece girilen her IP adresi uygulamanızı işaret eder.

export default defineConfig({
  // transpileDependencies: true,
  transpileDependencies: ["vuetify"],
  server: {
    host: '0.0.0.0',
    port: 3000 // the port number you want
  },
  plugins: [ ...

Yerel Sunucunuzu Başlatma

Yerel ortamda uygulamayı başlatır.

npm run dev

Yerel bir bilgisayarda çalışıyorsanız http://127.0.0.1:3000 adresini ziyaret edebilirsiniz. Eğer yerel bir sanal sunucu üzerinde çalışıyorsanız, tarayıcınıza sunucunuzun IP adresini yazıp bu örnekteki gibi bir IP adresini ziyaret edebilirsiniz; http://192.168.231.129:3000.

Projeyi İhraç Etmek

Bu komut ile produksiyon ortamı için derlenen javascript dosyalarınız /dist klasörü altına ihraç edilir.

npm run build

Güncellemeleri Almak

Projeyi yukarıdaki gibi kurduğunuzda olobase-admin projenize submodule olarak dahil olur.

- myproject
  + packages
    - admin   // (olobase-admin submodule)
      + src
        .git
        EULA.md
        package.json
        README.md
  + src
    .env.dev
    .gitignore
    .gitmodules
    app.css
    env.dist
    favicon.ico
    index.html
    package.json
    README.md
    vite.config.js

Bu paketi yeni sürümlere yükselterek olobase uygulamanızın güncel kalmasını sağlayabilirsiniz. Bunu yapmak için sürümler adresindeki sürümleri takip edin. Ve güncel sürümü yüklemek için aşağıdaki adımları izleyin.

cd /var/www/myproject

Mevcut klasör içinde packages/admin klasörüne girin.

cd packages/admin

olobase-admin alt uygulamanızı güncel sürüme yükseltin.

git pull origin 1.3.4

Uygulamanızın güncel kalması için olobase-admin submodülünüze ait sürümleri takip etmeyi unutmayın.

Alt Modülde Düzenleme mi Yaptınız ?

Eğer olobase-admin alt modülünüzde bazı değişiklikler yaptıysanız (yanlışlıkla veya test amaçlı vb.), pull komutundan önce (stash) yani yapılan değişiklikleri geçersiz kıl komutunu kullanmanız gerekir.

Değişikliklerden vazgeç (stash) ve ilgili versiyon için çek (pull) yapın.

cd packages/admin

git stash
git pull origin 1.3.4

Yukarıdaki Komutlar İşe Yaramadı mı ?

Yukarıdaki komutları denediğiniz halde hâlâ istediğiniz güncellemeyi alamadıysanız aşağıdaki komutları çalıştırmayı deneyin.

git restore .
// HEAD detached at 1.2.0

git pull origin 1.3.4
git checkout 1.3.4